--- type: "firecrawl-provider" description: "UN Comtrade international merchandise and services trade statistics through the anonymous public API behind comtradeplus.un.org: trade value, quantity and weight by reporter, partner, flow and commodity (HS/SITC/BEC/EBOPS), national tariff lines, dataset availability and metadata, recent releases, world shares, MBS total-trade series and the reference code tables." use_when: "UN Comtrade international merchandise and services trade statistics through the anonymous public API behind comtradeplus.un.org: trade value, quantity and weight by reporter, partner, flow and commodity (HS/SITC/BEC/EBOPS), national tariff lines, dataset availability and metadata, recent releases, world shares, MBS total-trade series and the reference code tables." categories: "Public records" capabilities: 8 credits_per_call: 5 --- # UN Comtrade (comtradeplus.un.org) on Firecrawl Alexandria UN Comtrade international merchandise and services trade statistics through the anonymous public API behind comtradeplus.un.org: trade value, quantity and weight by reporter, partner, flow and commodity (HS/SITC/BEC/EBOPS), national tariff lines, dataset availability and metadata, recent releases, world shares, MBS total-trade series and the reference code tables. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `comtradeplus-un-org` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/comtradeplus-un-org) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/openapi.json) ## Capabilities - [Data availability](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/data_availability): Which datasets UN Comtrade holds for a reporter, frequency, classification and period(s), with record counts, the HS edition actually reported and release dates (GET /public/v1/getDA or, with tariffline=true, /public/v1/getDATariffline). An empty list is a legitimate answer: nothing published for that selection. - [Dataset metadata](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/dataset_metadata): Publication notes and valuation metadata for a reporter's dataset(s) in a period: currency and conversion factors, trade system, import/export valuation (CIF/FOB), partner attribution and the publication note and date (GET /public/v1/getMetadata). No dataset for the selection is not_found. - [Mbs series](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/mbs_series): Monthly Bulletin of Statistics trade time series (GET /public/v1/getMBS): Table 35 total trade value (annual, quarterly or monthly, USD millions) and Table 38 conversion factors, for one or more countries. - [Recent releases](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/recent_releases): The most recent dataset releases and revisions published by UN Comtrade (GET /public/v1/getComtradeReleases), newest first as served, optionally filtered to one reporter. - [Reference codes](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/reference_codes): A UN Comtrade reference code table (GET /files/v1/app/reference/{table}.json): Reporters, partnerAreas, HS (all editions combined), H0-H6, S1-S4, SS, B4, B5, EB, EB02, EB10, EB10S, tradeRegimes (flows), ModeOfTransportCodes, CustomsCodes, QuantityUnits, ModeOfSupply, Frequency, TradeDataItems. Optional case-insensitive substring filter on code and text; rows pass through with the table's own columns. An unknown table name is not_found. - [Tariffline data](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/tariffline_data): National tariff-line trade records (reporter's own 8-10 digit codes) from the public tariffline preview (GET /public/v1/previewTariffline/{type}/{freq}/{classification}). One request per call; the API silently caps the answer at 500 records and `truncated` says so. Tariffline rows carry no description for national codes (cmd_desc null) and mode of transport / customs / second partner only where the reporter publishes them. - [Trade data](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/trade_data): Trade values, quantities and weights from the public preview of UN Comtrade (GET /public/v1/preview/{type}/{freq}/{classification}). One commodity code per call; the API accepts one period per request and silently caps each request at 500 records, so the function issues one request per requested period (up to 12, listed or as a range such as 2012-2019) and reports `truncated` per period. Partner omitted = breakdown by every partner; partner 0 = the reporter's world total. Values are USD as published (CIF for imports, FOB for exports); the full key-gated /data/v1 endpoint is not used. - [World share](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/world_share): A reporter's share of world trade for a period, including UN estimates where the reporter has not published (GET /public/v1/getWorldShare/{type}/{freq}), with availability and release dates. ## 1. Choose this provider when UN Comtrade international merchandise and services trade statistics through the anonymous public API behind comtradeplus.un.org: trade value, quantity and weight by reporter, partner, flow and commodity (HS/SITC/BEC/EBOPS), national tariff lines, dataset availability and metadata, recent releases, world shares, MBS total-trade series and the reference code tables. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "comtradeplus-un-org", "capability": "trade-statistics/data_availability", "options": { "period": "2012,2013,2014,2015,2016,2017,2018,2019", "reporter_code": "156" } } ``` ## 3. Add provider options Use only the options needed for the task: - `classification` (string): Product classification in the URL path: HS (as reported, any HS edition), H0-H6 (a specific HS edition), S1-S4 (SITC), BE/BE5 (BEC), EB/EB10/EB02/EBS (EBOPS, services). Example: `HS` - `freq_code` (string): Frequency: A annual (period YYYY), M monthly (period YYYYMM). Example: `A` - `period` (string): Period(s) YYYY or YYYYMM, comma-separated; omit for every period. Pattern: ^\d{4}(\d{2})?(,\d{4}(\d{2})?)*$. Example: `` - `reporter_code` (string, required): UN M49 numeric reporter code(s), comma-separated (156 China, 842 USA, 276 Germany). Look codes up with reference_codes table=Reporters. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `tariffline` (boolean): Query the tariffline dataset catalogue instead of the standard one. Example: `false` - `type_code` (string): Type of trade: C commodities (goods), S services. Example: `C` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "comtradeplus-un-org", capability: "trade-statistics/data_availability", options: { period: "2012,2013,2014,2015,2016,2017,2018,2019", reporter_code: "156", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "comtradeplus-un-org", "capability": "trade-statistics/data_availability", "options": { "period": "2012,2013,2014,2015,2016,2017,2018,2019", "reporter_code": "156" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "comtradeplus-un-org", "capability": "trade-statistics/data_availability", "options": { "period": "2012,2013,2014,2015,2016,2017,2018,2019", "reporter_code": "156" } } }' ``` ### CLI ```sh firecrawl scrape 'comtradeplus-un-org/trade-statistics/data_availability' \ --options '{"period":"2012,2013,2014,2015,2016,2017,2018,2019","reporter_code":"156"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "comtradeplus-un-org", "capability": "trade-statistics/data_availability", "options": { "period": "2012,2013,2014,2015,2016,2017,2018,2019", "reporter_code": "156" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "comtradeplus-un-org", "capability": "trade-statistics/data_availability", "options": { "period": "2012,2013,2014,2015,2016,2017,2018,2019", "reporter_code": "156" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "count": 8, "datasets": [ { "classification_code": "H4", "dataset_code": "20156201201092100", "first_released": "2013-05-22T23:19:21.98", "freq_code": "A", "is_original_classification": true, "last_released": "2013-05-22T23:19:21.98", "length_cmd_code": null, "period": "2012", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 696476, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201301092100", "first_released": "2014-06-17T16:53:27.77", "freq_code": "A", "is_original_classification": true, "last_released": "2014-06-17T16:53:27.77", "length_cmd_code": null, "period": "2013", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 709963, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201401092100", "first_released": "2015-05-07T15:34:46.78", "freq_code": "A", "is_original_classification": true, "last_released": "2017-06-28T16:19:59.03", "length_cmd_code": null, "period": "2014", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 730672, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201501092100", "first_released": "2016-05-25T20:53:01.2733333", "freq_code": "A", "is_original_classification": true, "last_released": "2017-06-29T02:31:54.9566667", "length_cmd_code": null, "period": "2015", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 2894591, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201601092100", "first_released": "2017-05-26T04:00:52.57", "freq_code": "A", "is_original_classification": true, "last_released": "2021-12-13T20:23:32.8933333", "length_cmd_code": null, "period": "2016", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 2991492, "type_code": "C" }, { "classification_code": "H5", "dataset_code": "20156201701182100", "first_released": "2018-08-16T14:55:42.4666667", "freq_code": "A", "is_original_classification": true, "last_released": "2018-08-16T14:55:42.4666667", "length_cmd_code": null, "period": "2017", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 3086454, "type_code": "C" }, { "classification_code": "H5", "dataset_code": "20156201801182100", "first_released": "2019-11-03T17:39:20.5066667", "freq_code": "A", "is_original_classification": true, "last_released": "2022-06-08T05:01:46.5066667", "length_cmd_code": null, "period": "2018", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 787828, "type_code": "C" }, { "classification_code": "H5", "dataset_code": "20156201901182100", "first_released": "2020-10-27T04:41:22.7", "freq_code": "A", "is_original_classification": true, "last_released": "2022-05-21T09:34:45.3933333", "length_cmd_code": null, "period": "2019", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 811658, "type_code": "C" } ], "observed_at_ms": 1792433666111, "request": { "classification": "HS", "freq_code": "A", "period": "2012,2013,2014,2015,2016,2017,2018,2019", "reporter_code": "156", "type_code": "C" }, "source_url": "https://comtradeapi.un.org/public/v1/getDA/C/A/HS?reporterCode=156&period=2012%2C2013%2C2014%2C2015%2C2016%2C2017%2C2018%2C2019" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Data availability - Capability: `trade-statistics/data_availability` - Description: Which datasets UN Comtrade holds for a reporter, frequency, classification and period(s), with record counts, the HS edition actually reported and release dates (GET /public/v1/getDA or, with tariffline=true, /public/v1/getDATariffline). An empty list is a legitimate answer: nothing published for that selection. - Instructions: Before pulling data: which years/months exist for a reporter, how many records each dataset has, when it was first and last released, which HS edition it uses. Also to resolve dataset_code values for dataset_metadata. - Cost: 5 credits per call - Capability file: [Data availability](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/data_availability) Accepted options: - `classification` (string): Product classification in the URL path: HS (as reported, any HS edition), H0-H6 (a specific HS edition), S1-S4 (SITC), BE/BE5 (BEC), EB/EB10/EB02/EBS (EBOPS, services). Example: `HS` - `freq_code` (string): Frequency: A annual (period YYYY), M monthly (period YYYYMM). Example: `A` - `period` (string): Period(s) YYYY or YYYYMM, comma-separated; omit for every period. Pattern: ^\d{4}(\d{2})?(,\d{4}(\d{2})?)*$. Example: `` - `reporter_code` (string, required): UN M49 numeric reporter code(s), comma-separated (156 China, 842 USA, 276 Germany). Look codes up with reference_codes table=Reporters. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `tariffline` (boolean): Query the tariffline dataset catalogue instead of the standard one. Example: `false` - `type_code` (string): Type of trade: C commodities (goods), S services. Example: `C` Response schema example: ```json { "count": 8, "datasets": [ { "classification_code": "H4", "dataset_code": "20156201201092100", "first_released": "2013-05-22T23:19:21.98", "freq_code": "A", "is_original_classification": true, "last_released": "2013-05-22T23:19:21.98", "length_cmd_code": null, "period": "2012", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 696476, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201301092100", "first_released": "2014-06-17T16:53:27.77", "freq_code": "A", "is_original_classification": true, "last_released": "2014-06-17T16:53:27.77", "length_cmd_code": null, "period": "2013", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 709963, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201401092100", "first_released": "2015-05-07T15:34:46.78", "freq_code": "A", "is_original_classification": true, "last_released": "2017-06-28T16:19:59.03", "length_cmd_code": null, "period": "2014", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 730672, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201501092100", "first_released": "2016-05-25T20:53:01.2733333", "freq_code": "A", "is_original_classification": true, "last_released": "2017-06-29T02:31:54.9566667", "length_cmd_code": null, "period": "2015", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 2894591, "type_code": "C" }, { "classification_code": "H4", "dataset_code": "20156201601092100", "first_released": "2017-05-26T04:00:52.57", "freq_code": "A", "is_original_classification": true, "last_released": "2021-12-13T20:23:32.8933333", "length_cmd_code": null, "period": "2016", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 2991492, "type_code": "C" }, { "classification_code": "H5", "dataset_code": "20156201701182100", "first_released": "2018-08-16T14:55:42.4666667", "freq_code": "A", "is_original_classification": true, "last_released": "2018-08-16T14:55:42.4666667", "length_cmd_code": null, "period": "2017", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 3086454, "type_code": "C" }, { "classification_code": "H5", "dataset_code": "20156201801182100", "first_released": "2019-11-03T17:39:20.5066667", "freq_code": "A", "is_original_classification": true, "last_released": "2022-06-08T05:01:46.5066667", "length_cmd_code": null, "period": "2018", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 787828, "type_code": "C" }, { "classification_code": "H5", "dataset_code": "20156201901182100", "first_released": "2020-10-27T04:41:22.7", "freq_code": "A", "is_original_classification": true, "last_released": "2022-05-21T09:34:45.3933333", "length_cmd_code": null, "period": "2019", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "total_records": 811658, "type_code": "C" } ], "observed_at_ms": 1792433666111, "request": { "classification": "HS", "freq_code": "A", "period": "2012,2013,2014,2015,2016,2017,2018,2019", "reporter_code": "156", "type_code": "C" }, "source_url": "https://comtradeapi.un.org/public/v1/getDA/C/A/HS?reporterCode=156&period=2012%2C2013%2C2014%2C2015%2C2016%2C2017%2C2018%2C2019" } ``` ### Dataset metadata - Capability: `trade-statistics/dataset_metadata` - Description: Publication notes and valuation metadata for a reporter's dataset(s) in a period: currency and conversion factors, trade system, import/export valuation (CIF/FOB), partner attribution and the publication note and date (GET /public/v1/getMetadata). No dataset for the selection is not_found. - Instructions: How a reporter's figures for a year were compiled (CIF vs FOB, general vs special trade system, source agency note, revision date) before comparing them with another reporter's. - Cost: 5 credits per call - Capability file: [Dataset metadata](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/dataset_metadata) Accepted options: - `classification` (string): Product classification in the URL path: HS (as reported, any HS edition), H0-H6 (a specific HS edition), S1-S4 (SITC), BE/BE5 (BEC), EB/EB10/EB02/EBS (EBOPS, services). Example: `HS` - `freq_code` (string): Frequency: A annual (period YYYY), M monthly (period YYYYMM). Example: `A` - `period` (string, required): Period(s) YYYY or YYYYMM, comma-separated. Pattern: ^\d{4}(\d{2})?(,\d{4}(\d{2})?)*$. Example: `` - `reporter_code` (string, required): UN M49 numeric reporter code(s), comma-separated (156 China, 842 USA, 276 Germany). Look codes up with reference_codes table=Reporters. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `type_code` (string): Type of trade: C commodities (goods), S services. Example: `C` Response schema example: ```json { "count": 1, "datasets": [ { "dataset_code": "20156201901182100", "freq_code": "A", "notes": [ { "classification_code": "H5", "currency": "USD", "export_conv_factor": "1", "export_partner2_country": "N/A", "export_partner_country": "Last Known Destination", "export_valuation": "FOB", "import_conv_factor": "1", "import_partner2_country": "N/A", "import_partner_country": "Origin", "import_valuation": "CIF", "publication_date": "2021-12-09T15:18:45.12", "publication_note": "New Data: Data for this period is published for the first time; the new data was collected from General Customs Administration of China through ITC on 12 Oct 20.", "reporter_description": "China", "trade_system": "General" } ], "period": "2019", "reporter_code": 156, "type_code": "C" } ], "observed_at_ms": 1792433678069, "request": { "classification": "HS", "freq_code": "A", "period": "2019", "reporter_code": "156", "type_code": "C" }, "source_url": "https://comtradeapi.un.org/public/v1/getMetadata/C/A/HS?reporterCode=156&period=2019" } ``` ### Mbs series - Capability: `trade-statistics/mbs_series` - Description: Monthly Bulletin of Statistics trade time series (GET /public/v1/getMBS): Table 35 total trade value (annual, quarterly or monthly, USD millions) and Table 38 conversion factors, for one or more countries. - Instructions: Headline total imports/exports of a country over time (back to 1946) in one call, rather than summing commodity rows; or the exchange-rate conversion factors behind them. - Cost: 5 credits per call - Capability file: [Mbs series](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/mbs_series) Accepted options: - `country_code` (string, required): UN M49 country code(s), comma-separated. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `period` (string): Period(s) YYYY or YYYYMM, comma-separated. Pattern: ^\d{4}(\d{2})?(,\d{4}(\d{2})?)*$. Example: `` - `period_type` (string): Restrict to annual, quarterly or monthly observations. Example: `A` - `series_type` (string): Table.frequency.measure.currency: T35 total trade value in USD, T38 conversion factors; A annual, Q quarterly, M monthly. Example: `T35.A.V.$` - `table_type` (string): Restrict to one MBS table. Example: `T35` - `year` (string): Reference year(s), comma-separated; omit for every year. Pattern: ^\d{4}(,\d{4})*$. Example: `` Response schema example: ```json { "count": 2, "observations": [ { "base_year": null, "commodity_group_code": "1", "commodity_group_name": "Total", "country_code": 156, "country_name": "China", "currency_type": "$", "estimation_type": "A", "estimation_type_desc": "Actual", "partner_country_code": 0, "partner_country_name": "World", "period": "201952", "period_in_date": "01/01/2019", "period_type": "A", "series_type": "T35.A.V.$", "table_type": "T35", "table_type_desc": "Total trade - value", "trade_flow": "X", "trade_flow_desc": "Exports", "value": 2500000, "value_type": "V", "value_unit": "M", "year": 2019 }, { "base_year": null, "commodity_group_code": "1", "commodity_group_name": "Total", "country_code": 156, "country_name": "China", "currency_type": "$", "estimation_type": "A", "estimation_type_desc": "Actual", "partner_country_code": 0, "partner_country_name": "World", "period": "201952", "period_in_date": "01/01/2019", "period_type": "A", "series_type": "T35.A.V.$", "table_type": "T35", "table_type_desc": "Total trade - value", "trade_flow": "M", "trade_flow_desc": "Imports", "value": 2070000, "value_type": "V", "value_unit": "M", "year": 2019 } ], "observed_at_ms": 1792433732675, "request": { "country_code": "156", "period": null, "period_type": "A", "series_type": "T35.A.V.$", "table_type": null, "year": "2019" }, "source_url": "https://comtradeapi.un.org/public/v1/getMBS?series_type=T35.A.V.%24&year=2019&country_code=156&period_type=A" } ``` ### Recent releases - Capability: `trade-statistics/recent_releases` - Description: The most recent dataset releases and revisions published by UN Comtrade (GET /public/v1/getComtradeReleases), newest first as served, optionally filtered to one reporter. - Instructions: What was published or revised in the last days, or whether a given country's new annual or monthly data has landed. - Cost: 5 credits per call - Capability file: [Recent releases](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/recent_releases) Accepted options: - `reporter_code` (string): Keep only releases of this UN M49 reporter code. Pattern: ^\d{1,4}$. Example: `` Response schema example: ```json { "count": 49, "observed_at_ms": 1792433696578, "releases": [ { "dataset_desc": "Papua New Guinea CA 2024", "date_release": "2026-10-18T00:00:00", "flag_code": "PG", "release_type": "new", "reporter_code": 598 }, { "dataset_desc": "Côte d'Ivoire CM 201811", "date_release": "2026-10-16T00:00:00", "flag_code": "CI", "release_type": "revised", "reporter_code": 384 }, { "dataset_desc": "Croatia CM 202602", "date_release": "2026-10-16T00:00:00", "flag_code": "HR", "release_type": "revised", "reporter_code": 191 }, { "dataset_desc": "Poland CM 202601", "date_release": "2026-10-16T00:00:00", "flag_code": "PL", "release_type": "revised", "reporter_code": 616 }, { "dataset_desc": "Cabo Verde CA 2025", "date_release": "2026-10-16T00:00:00", "flag_code": "CV", "release_type": "new", "reporter_code": 132 }, { "dataset_desc": "Poland CM 202604", "date_release": "2026-10-16T00:00:00", "flag_code": "PL", "release_type": "revised", "reporter_code": 616 }, { "dataset_desc": "Bulgaria CM 202407", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Poland CM 202607", "date_release": "2026-10-16T00:00:00", "flag_code": "PL", "release_type": "new", "reporter_code": 616 }, { "dataset_desc": "Bulgaria CM 202410", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Poland CM 202603", "date_release": "2026-10-16T00:00:00", "flag_code": "PL", "release_type": "revised", "reporter_code": 616 }, { "dataset_desc": "Bulgaria CM 202401", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Poland CM 202606", "date_release": "2026-10-16T00:00:00", "flag_code": "PL", "release_type": "revised", "reporter_code": 616 }, { "dataset_desc": "Bulgaria CM 202404", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Poland CM 202602", "date_release": "2026-10-16T00:00:00", "flag_code": "PL", "release_type": "revised", "reporter_code": 616 }, { "dataset_desc": "Bulgaria CM 202402", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Poland CM 202605", "date_release": "2026-10-16T00:00:00", "flag_code": "PL", "release_type": "revised", "reporter_code": 616 }, { "dataset_desc": "Bulgaria CM 202405", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Bulgaria CM 202408", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Bulgaria CM 202403", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Bulgaria CM 202406", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Bulgaria CM 202409", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Bulgaria CM 202412", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Bulgaria CM 202411", "date_release": "2026-10-16T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Germany CM 202410", "date_release": "2026-10-15T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Japan CM 202608", "date_release": "2026-10-15T00:00:00", "flag_code": "JP", "release_type": "new", "reporter_code": 392 }, { "dataset_desc": "Germany CM 202409", "date_release": "2026-10-15T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Bulgaria CM 202602", "date_release": "2026-10-15T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Germany CM 202412", "date_release": "2026-10-15T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Bulgaria CM 202603", "date_release": "2026-10-15T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Nicaragua CA 2025", "date_release": "2026-10-14T00:00:00", "flag_code": "NI", "release_type": "new", "reporter_code": 558 }, { "dataset_desc": "Croatia CM 202605", "date_release": "2026-10-14T00:00:00", "flag_code": "HR", "release_type": "revised", "reporter_code": 191 }, { "dataset_desc": "Germany CM 202405", "date_release": "2026-10-14T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Bulgaria CM 202601", "date_release": "2026-10-14T00:00:00", "flag_code": "BG", "release_type": "revised", "reporter_code": 100 }, { "dataset_desc": "Germany CM 202408", "date_release": "2026-10-14T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Canada CM 202606", "date_release": "2026-10-14T00:00:00", "flag_code": "CA", "release_type": "revised", "reporter_code": 124 }, { "dataset_desc": "Germany CM 202407", "date_release": "2026-10-14T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Canada CM 202605", "date_release": "2026-10-14T00:00:00", "flag_code": "CA", "release_type": "revised", "reporter_code": 124 }, { "dataset_desc": "Germany CM 202406", "date_release": "2026-10-14T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Croatia CM 202603", "date_release": "2026-10-14T00:00:00", "flag_code": "HR", "release_type": "revised", "reporter_code": 191 }, { "dataset_desc": "Croatia CM 202601", "date_release": "2026-10-14T00:00:00", "flag_code": "HR", "release_type": "revised", "reporter_code": 191 }, { "dataset_desc": "Croatia CM 202604", "date_release": "2026-10-14T00:00:00", "flag_code": "HR", "release_type": "revised", "reporter_code": 191 }, { "dataset_desc": "Philippines CM 202607", "date_release": "2026-10-13T00:00:00", "flag_code": "PH", "release_type": "new", "reporter_code": 608 }, { "dataset_desc": "Croatia CM 202607", "date_release": "2026-10-13T00:00:00", "flag_code": "HR", "release_type": "new", "reporter_code": 191 }, { "dataset_desc": "Cambodia CA 2025", "date_release": "2026-10-13T00:00:00", "flag_code": "KH", "release_type": "new", "reporter_code": 116 }, { "dataset_desc": "Germany CM 202403", "date_release": "2026-10-13T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Germany CM 202401", "date_release": "2026-10-13T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Germany CM 202404", "date_release": "2026-10-13T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Germany CM 202402", "date_release": "2026-10-13T00:00:00", "flag_code": "DE", "release_type": "revised", "reporter_code": 276 }, { "dataset_desc": "Rwanda CA 2023", "date_release": "2026-10-13T00:00:00", "flag_code": "RW", "release_type": "new", "reporter_code": 646 } ], "source_url": "https://comtradeapi.un.org/public/v1/getComtradeReleases" } ``` ### Reference codes - Capability: `trade-statistics/reference_codes` - Description: A UN Comtrade reference code table (GET /files/v1/app/reference/{table}.json): Reporters, partnerAreas, HS (all editions combined), H0-H6, S1-S4, SS, B4, B5, EB, EB02, EB10, EB10S, tradeRegimes (flows), ModeOfTransportCodes, CustomsCodes, QuantityUnits, ModeOfSupply, Frequency, TradeDataItems. Optional case-insensitive substring filter on code and text; rows pass through with the table's own columns. An unknown table name is not_found. - Instructions: Resolve a country or product name to the numeric/HS code the other functions need (China -> 156, 'static converters' -> 850440), or list the valid flow, customs or transport codes. - Cost: 5 credits per call - Capability file: [Reference codes](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/reference_codes) Accepted options: - `limit` (number): Maximum rows returned after filtering (HS has 8262 rows). Example: `200` - `query` (string): Keep rows whose id or text contains this (case-insensitive). Example: `` - `table` (string, required): Table name as listed above (case-sensitive, as the file is named). Pattern: ^[A-Za-z0-9]{1,32}$. Example: `` Response schema example: ```json { "codes": [ { "entryEffectiveDate": "1900-01-01T00:00:00", "id": "156", "isGroup": false, "reporterCode": 156, "reporterCodeIsoAlpha2": "CN", "reporterCodeIsoAlpha3": "CHN", "reporterDesc": "China", "reporterNote": "China", "text": "China" }, { "entryEffectiveDate": "1900-01-01T00:00:00", "id": "344", "isGroup": false, "reporterCode": 344, "reporterCodeIsoAlpha2": "HK", "reporterCodeIsoAlpha3": "HKG", "reporterDesc": "China, Hong Kong SAR", "reporterNote": "China, Hong Kong Special Administrative Region", "text": "China, Hong Kong SAR" }, { "entryEffectiveDate": "1900-01-01T00:00:00", "id": "446", "isGroup": false, "reporterCode": 446, "reporterCodeIsoAlpha2": "MO", "reporterCodeIsoAlpha3": "MAC", "reporterDesc": "China, Macao SAR", "reporterNote": "China, Macao Special Administrative Region", "text": "China, Macao SAR" } ], "count": 3, "matched": 3, "observed_at_ms": 1792433743469, "query": "China", "source_url": "https://comtradeapi.un.org/files/v1/app/reference/Reporters.json", "table": "Reporters", "total": 255 } ``` ### Tariffline data - Capability: `trade-statistics/tariffline_data` - Description: National tariff-line trade records (reporter's own 8-10 digit codes) from the public tariffline preview (GET /public/v1/previewTariffline/{type}/{freq}/{classification}). One request per call; the API silently caps the answer at 500 records and `truncated` says so. Tariffline rows carry no description for national codes (cmd_desc null) and mode of transport / customs / second partner only where the reporter publishes them. - Instructions: Which national tariff lines under an HS6 code a reporter traded with a partner in a period, with value, quantity and weight, e.g. USA imports from China under 850440 in 2019. For HS6-and-above aggregates use trade_data. - Cost: 5 credits per call - Capability file: [Tariffline data](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/tariffline_data) Accepted options: - `classification` (string): HS edition in the URL path (tariffline is goods only). Example: `HS` - `cmd_code` (string): Commodity code(s), comma-separated: HS6 codes select every national line beneath them; national 8-10 digit codes are accepted as the reporter publishes them. Pattern: ^[A-Za-z0-9]{1,12}(,[A-Za-z0-9]{1,12})*$. Example: `` - `customs_code` (string): Customs procedure code(s), comma-separated (C00 total). Pattern: ^[A-Za-z0-9]{1,4}(,[A-Za-z0-9]{1,4})*$. Example: `` - `flow_code` (string): Trade flow code(s), comma-separated: M import, X export, RM re-import, RX re-export, MIP/XIP/MOP/XOP/MIF/XIF/DX/FM sub-flows. Omit for every flow. Pattern: ^[A-Za-z]{1,3}(,[A-Za-z]{1,3})*$. Example: `` - `freq_code` (string): Frequency: A annual (period YYYY), M monthly (period YYYYMM). Example: `A` - `include_desc` (boolean): Ask the API for description and ISO columns. Example: `false` - `mot_code` (string): Mode of transport code(s), comma-separated (0 total). Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `partner2_code` (string): Second partner (consignment) code(s), comma-separated. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `partner_code` (string): Partner area code(s), comma-separated. 0 is World (the reporter's total); omit for a breakdown by every partner. Look codes up with reference_codes table=partnerAreas. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `period` (string, required): Period(s) YYYY or YYYYMM, comma-separated. Pattern: ^\d{4}(\d{2})?(,\d{4}(\d{2})?)*$. Example: `` - `reporter_code` (string, required): UN M49 numeric reporter code(s), comma-separated (156 China, 842 USA, 276 Germany). Look codes up with reference_codes table=Reporters. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `type_code` (string): Type of trade: C commodities (goods), S services. Example: `C` Response schema example: ```json { "count": 2, "observed_at_ms": 1792433645386, "records": [ { "aggr_level": null, "alt_qty": 0, "alt_qty_unit_abbr": "N/A", "cif_value": 11799, "classification_code": "H5", "cmd_code": "8504409570", "cmd_desc": null, "customs_code": "-1", "customs_desc": "N/A", "flow_code": "M", "flow_desc": "Import", "fob_value": 11505, "freq_code": "A", "gross_wgt": 0, "is_aggregate": null, "is_leaf": null, "is_net_wgt_estimated": null, "is_qty_estimated": null, "is_reported": null, "mot_code": -1, "mot_desc": "Not available or not specified.", "net_wgt": 0, "partner2_code": -1, "partner2_desc": "N/A", "partner_code": 352, "partner_desc": "Iceland", "partner_iso": "ISL", "period": "2019", "primary_value": 11799, "qty": 4, "qty_unit_abbr": "u", "qty_unit_code": 5, "reporter_code": 842, "reporter_desc": "USA", "reporter_iso": "USA", "type_code": "C" }, { "aggr_level": null, "alt_qty": 0, "alt_qty_unit_abbr": "N/A", "cif_value": 4164, "classification_code": "H5", "cmd_code": "8504409570", "cmd_desc": null, "customs_code": "-1", "customs_desc": "N/A", "flow_code": "M", "flow_desc": "Import", "fob_value": 4061, "freq_code": "A", "gross_wgt": 0, "is_aggregate": null, "is_leaf": null, "is_net_wgt_estimated": null, "is_qty_estimated": null, "is_reported": null, "mot_code": -1, "mot_desc": "Not available or not specified.", "net_wgt": 0, "partner2_code": -1, "partner2_desc": "N/A", "partner_code": 352, "partner_desc": "Iceland", "partner_iso": "ISL", "period": "2019", "primary_value": 4164, "qty": 5, "qty_unit_abbr": "u", "qty_unit_code": 5, "reporter_code": 842, "reporter_desc": "USA", "reporter_iso": "USA", "type_code": "C" } ], "request": { "classification": "HS", "cmd_code": "850440", "customs_code": null, "flow_code": "M", "freq_code": "A", "include_desc": true, "mot_code": null, "partner2_code": null, "partner_code": "352", "period": "2019", "reporter_code": "842", "type_code": "C" }, "source_url": "https://comtradeapi.un.org/public/v1/previewTariffline/C/A/HS?reporterCode=842&period=2019&partnerCode=352&flowCode=M&cmdCode=850440&includeDesc=true", "truncated": false } ``` ### Trade data - Capability: `trade-statistics/trade_data` - Description: Trade values, quantities and weights from the public preview of UN Comtrade (GET /public/v1/preview/{type}/{freq}/{classification}). One commodity code per call; the API accepts one period per request and silently caps each request at 500 records, so the function issues one request per requested period (up to 12, listed or as a range such as 2012-2019) and reports `truncated` per period. Partner omitted = breakdown by every partner; partner 0 = the reporter's world total. Values are USD as published (CIF for imports, FOB for exports); the full key-gated /data/v1 endpoint is not used. - Instructions: Annual or monthly import/export value, net weight and quantity of one HS/SITC/BEC/EBOPS code (or TOTAL, AG2/AG4/AG6 aggregates) for a reporter, optionally broken down by partner, e.g. China HS6 850440 imports 2012-2019. - Cost: 5 credits per call - Capability file: [Trade data](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/trade_data) Accepted options: - `classification` (string): Product classification in the URL path: HS (as reported, any HS edition), H0-H6 (a specific HS edition), S1-S4 (SITC), BE/BE5 (BEC), EB/EB10/EB02/EBS (EBOPS, services). Example: `HS` - `cmd_code` (string): One commodity code: TOTAL, an HS/SITC/BEC/EBOPS code at any level (85, 8504, 850440), or an aggregate alias AG2/AG4/AG6 for every code at that digit level. Default TOTAL. Pattern: ^[A-Za-z0-9]{1,12}$. Example: `TOTAL` - `flow_code` (string): Trade flow code(s), comma-separated: M import, X export, RM re-import, RX re-export, MIP/XIP/MOP/XOP/MIF/XIF/DX/FM sub-flows. Omit for every flow. Pattern: ^[A-Za-z]{1,3}(,[A-Za-z]{1,3})*$. Example: `` - `freq_code` (string): Frequency: A annual (period YYYY), M monthly (period YYYYMM). Example: `A` - `include_desc` (boolean): Ask the API for description and ISO columns (reporter_desc, partner_iso, cmd_desc ...). When false those come back null. Example: `false` - `partner_code` (string): Partner area code(s), comma-separated. 0 is World (the reporter's total); omit for a breakdown by every partner. Look codes up with reference_codes table=partnerAreas. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `period` (string, required): Period(s): YYYY (annual) or YYYYMM (monthly); a comma-separated list and/or inclusive ranges (2012-2019, 201901-201906). At most 12 periods after expansion; each costs one upstream request. Pattern: ^\d{4}(\d{2})?(-\d{4}(\d{2})?)?(,\d{4}(\d{2})?(-\d{4}(\d{2})?)?)*$. Example: `` - `reporter_code` (string, required): UN M49 numeric reporter code(s), comma-separated (156 China, 842 USA, 276 Germany). Look codes up with reference_codes table=Reporters. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `type_code` (string): Type of trade: C commodities (goods), S services. Example: `C` Response schema example: ```json { "count": 1, "observed_at_ms": 1792433616822, "periods": [ { "count": 1, "period": "2019", "source_url": "https://comtradeapi.un.org/public/v1/preview/C/A/HS?reporterCode=156&period=2019&partnerCode=0&flowCode=M&cmdCode=850440&includeDesc=true", "truncated": false } ], "records": [ { "aggr_level": 6, "alt_qty": 2189054044, "alt_qty_unit_abbr": "u", "cif_value": 7111977093, "classification_code": "H5", "cmd_code": "850440", "cmd_desc": "Electrical static converters", "customs_code": "C00", "customs_desc": "TOTAL CPC", "flow_code": "M", "flow_desc": "Import", "fob_value": 0, "freq_code": "A", "gross_wgt": 0, "is_aggregate": true, "is_leaf": true, "is_net_wgt_estimated": true, "is_qty_estimated": true, "is_reported": false, "mot_code": 0, "mot_desc": "TOTAL MOT", "net_wgt": 142925552.458, "partner2_code": 0, "partner2_desc": "World", "partner_code": 0, "partner_desc": "World", "partner_iso": "W00", "period": "2019", "primary_value": 7111977093, "qty": 2189051044.308, "qty_unit_abbr": "u", "qty_unit_code": 5, "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "type_code": "C" } ], "request": { "classification": "HS", "cmd_code": "850440", "flow_code": "M", "freq_code": "A", "include_desc": true, "partner_code": "0", "periods": [ "2019" ], "reporter_code": "156", "type_code": "C" }, "truncated": false } ``` ### World share - Capability: `trade-statistics/world_share` - Description: A reporter's share of world trade for a period, including UN estimates where the reporter has not published (GET /public/v1/getWorldShare/{type}/{freq}), with availability and release dates. - Instructions: How large a reporter is in world goods or services trade in a year or month, and whether its figures for that period are published or estimated. - Cost: 5 credits per call - Capability file: [World share](https://firecrawl.dev/alexandria/agents/providers/comtradeplus-un-org/trade-statistics/world_share) Accepted options: - `freq_code` (string): Frequency: A annual (period YYYY), M monthly (period YYYYMM). Example: `A` - `period` (string, required): Period(s) YYYY or YYYYMM, comma-separated, or `recent`. Pattern: ^(recent|\d{4}(\d{2})?(,\d{4}(\d{2})?)*)$. Example: `` - `reporter_code` (string, required): UN M49 numeric reporter code(s), comma-separated (156 China, 842 USA, 276 Germany). Look codes up with reference_codes table=Reporters. Pattern: ^\d{1,4}(,\d{1,4})*$. Example: `` - `type_code` (string): Type of trade: C commodities (goods), S services. Example: `C` Response schema example: ```json { "count": 1, "observed_at_ms": 1792433707432, "request": { "freq_code": "A", "period": "2019", "reporter_code": "156", "type_code": "C" }, "shares": [ { "data_count": 1, "dataset_desc": "China CA 2019", "first_released": "2020-10-27T04:41:22.7", "freq_code": "A", "is_available": true, "last_released": "2022-05-21T09:34:45.3933333", "period": "2019", "reporter_code": 156, "reporter_desc": "China", "reporter_iso": "CHN", "type_code": "C", "world_share": 0.12031413468204072 } ], "source_url": "https://comtradeapi.un.org/public/v1/getWorldShare/C/A?period=2019&reporterCode=156" } ```