--- type: "firecrawl-provider" description: "Discover UN Tourism free statistical files and indicators, and read live country-year tourism observations with source units, flags and editions." use_when: "Discover UN Tourism free statistical files and indicators, and read live country-year tourism observations with source units, flags and editions." categories: "Travel" capabilities: 3 credits_per_call: 5 --- # UN Tourism on Firecrawl Alexandria Discover UN Tourism free statistical files and indicators, and read live country-year tourism observations with source units, flags and editions. - Categories: Travel - Category index: [Travel category](https://firecrawl.dev/alexandria/agents/categories/travel) - Provider key: `untourism-int` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/untourism-int) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/untourism-int/openapi.json) ## Capabilities - [Data](https://firecrawl.dev/alexandria/agents/providers/untourism-int/statistics/data): Country-year observations for up to 10 indicator codes (from `indicators`), parsed live from the official Excel files: value as source text (null for blank/suppressed cells with the reason in series_note), unit copied from the file, SDMX flag and label, provisional marker, country as ISO3 + M49 + label, file edition and publication date. Filter by ISO3 `countries`, `year_from`/`year_to` and, for arrivals-by-region, `partner` (total | all | UN Tourism region code). Cursor-paginated, deterministic order. - [Files](https://firecrawl.dev/alexandria/agents/providers/untourism-int/statistics/files): The official UN Tourism Key Tourism Statistics Excel files (13 files: inbound arrivals/expenditure/by region/by purpose/by transport/accommodation, outbound departures/expenditure, domestic trips/accommodation, hotel capacity and occupancy, employment SDG 8.9.2, tourism GDP SDG 8.9.1). One live HEAD per file returns Last-Modified as source_updated_at, ETag and S3 version id, and changed_since_catalog flags a re-publication since the embedded catalogue. - [Indicators](https://firecrawl.dev/alexandria/agents/providers/untourism-int/statistics/indicators): Search the 148 free indicators (code, name, series group, unit, source file). `query` matches words in the code, name, previous Compendium code, unit, file id or common synonyms (receipts -> inbound expenditure, occupancy -> hotel room/bed rates); `series_group` narrows to inbound, outbound, domestic, industries, employment or macro. Cursor-paginated; each page carries the live publication date of its source files. ## 1. Choose this provider when Discover UN Tourism free statistical files and indicators, and read live country-year tourism observations with source units, flags and editions. ## 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": "untourism-int", "capability": "statistics/data", "options": { "countries": [ "ESP" ], "indicator_codes": [ "INBD_EXPD_BPAY_TOTL_VSTR" ], "year_from": 2024, "year_to": 2024 } } ``` ## 3. Add provider options Use only the options needed for the task: - `countries` (string[]): ISO 3166-1 alpha-3 codes. Omit or empty for every reporter (countries, territories and, in the SDG files, regional aggregates). Example: `[]` - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `indicator_codes` (string[], required): Indicator codes such as INBD_TRIP_TOTL_TOTL_TOUR (international tourist arrivals, overnight). Legacy Compendium codes such as CP_1_2 are accepted when a free equivalent exists. Codes spanning more than 3 source files are rejected. Example: `[]` - `page_size` (number): page_size Example: `100` - `partner` (string): Arrivals-by-region only: "total" (default: World / no partner dimension), "all" for every region of origin, or a UN Tourism region code (10000 Africa, 20000 Americas, 30000 East Asia and the Pacific, 40000 Europe, 50000 Middle East, 60000 South Asia, 70000 Other not classified). Example: `` - `year_from` (number): year_from Example: `1995` - `year_to` (number): year_to Example: `1995` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "untourism-int", capability: "statistics/data", options: { countries: [ "ESP", ], indicator_codes: [ "INBD_EXPD_BPAY_TOTL_VSTR", ], year_from: 2024, year_to: 2024, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "untourism-int", "capability": "statistics/data", "options": { "countries": [ "ESP" ], "indicator_codes": [ "INBD_EXPD_BPAY_TOTL_VSTR" ], "year_from": 2024, "year_to": 2024 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "untourism-int", "capability": "statistics/data", "options": { "countries": [ "ESP" ], "indicator_codes": [ "INBD_EXPD_BPAY_TOTL_VSTR" ], "year_from": 2024, "year_to": 2024 } } }' ``` ### CLI ```sh firecrawl scrape 'untourism-int/statistics/data' \ --options '{"countries":["ESP"],"indicator_codes":["INBD_EXPD_BPAY_TOTL_VSTR"],"year_from":2024,"year_to":2024}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "untourism-int", "capability": "statistics/data", "options": { "countries": [ "ESP" ], "indicator_codes": [ "INBD_EXPD_BPAY_TOTL_VSTR" ], "year_from": 2024, "year_to": 2024 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "untourism-int", "capability": "statistics/data", "options": { "countries": [ "ESP" ], "indicator_codes": [ "INBD_EXPD_BPAY_TOTL_VSTR" ], "year_from": 2024, "year_to": 2024 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "catalog_version": "2026-09-11", "complete": true, "count": 1, "countries_m49": [ 724 ], "files": [ { "changed_since_catalog": false, "edition": "12.2025", "etag": "97538b097e596a427f2967a2eaaf3630", "file_id": "inbound_expenditure", "release_label": "23 December 2025", "rows_in_file": 13987, "source_updated_at": "2026-01-02T13:06:42Z", "url": "https://pre-webunwto.s3.amazonaws.com/s3fs-public/2025-12/UN_Tourism_inbound_expenditure_12_2025.xlsx", "version_id": "htMhLThP8bDcgtu2mdezemsaX7fMlQUq" } ], "indicator_codes": [ "INBD_EXPD_BPAY_TOTL_VSTR" ], "license": "UN Tourism content is copyrighted. The free Key Tourism Statistics files are provided for non-commercial use with attribution (see the file's suggested citation); redistribution requires permission from UN Tourism. Terms: https://www.untourism.int/copyright", "next_cursor": null, "observed_at_ms": 1789084800000, "offset": 0, "page_size": 100, "records": [ { "area_kind": "country", "country": "Spain", "edition": "12.2025", "file_id": "inbound_expenditure", "flag": null, "flag_label": null, "id": "inbound_expenditure|INBD_EXPD_BPAY_TOTL_VSTR|724|999|2024", "indicator_code": "INBD_EXPD_BPAY_TOTL_VSTR", "indicator_name": "inbound - expenditure - balance of payments - total - visitors", "indicator_previous_code": "CP_1_33", "iso3": "ESP", "m49_code": 724, "notes": "Calculated as sum of the travel and passenger transport components", "observed_at_ms": 1789084800000, "partner_area": "World", "partner_area_code": 999, "provisional": false, "release_date": "2025-12-23", "series_note": "Calculated as sum of the travel and passenger transport components", "source": null, "source_file": "https://pre-webunwto.s3.amazonaws.com/s3fs-public/2025-12/UN_Tourism_inbound_expenditure_12_2025.xlsx", "source_updated_at": "2026-01-02T13:06:42Z", "source_url": "https://www.untourism.int/tourism-statistics/tourism-data-inbound-tourism", "unit": "million US dollars (nominal values)", "unit_note": "multiplier 1,000,000; currency USD; nominal (current) prices", "value": "106656.535197297", "value_number": 106656.535197297, "year": 2024 } ], "retrieved_at": "2026-09-11T00:00:00Z", "schema_version": "1.0.0", "source_updated_at": "2026-01-02T13:06:42Z", "total": 1, "warnings": [], "year_from": 2024, "year_to": 2024 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Data - Capability: `statistics/data` - Description: Country-year observations for up to 10 indicator codes (from `indicators`), parsed live from the official Excel files: value as source text (null for blank/suppressed cells with the reason in series_note), unit copied from the file, SDMX flag and label, provisional marker, country as ISO3 + M49 + label, file edition and publication date. Filter by ISO3 `countries`, `year_from`/`year_to` and, for arrivals-by-region, `partner` (total | all | UN Tourism region code). Cursor-paginated, deterministic order. - Instructions: Country-year observations for up to 10 indicator codes (from `indicators`), parsed live from the official Excel files: value as source text (null for blank/suppressed cells with the reason in series_note), unit copied from the file, SDMX flag and label, provisional marker, country as ISO3 + M49 + label, file edition and publication date. Filter by ISO3 `countries`, `year_from`/`year_to` and, for arrivals-by-region, `partner` (total | all | UN Tourism region code). Cursor-paginated, deterministic order. - Cost: 5 credits per call - Capability file: [Data](https://firecrawl.dev/alexandria/agents/providers/untourism-int/statistics/data) Accepted options: - `countries` (string[]): ISO 3166-1 alpha-3 codes. Omit or empty for every reporter (countries, territories and, in the SDG files, regional aggregates). Example: `[]` - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `indicator_codes` (string[], required): Indicator codes such as INBD_TRIP_TOTL_TOTL_TOUR (international tourist arrivals, overnight). Legacy Compendium codes such as CP_1_2 are accepted when a free equivalent exists. Codes spanning more than 3 source files are rejected. Example: `[]` - `page_size` (number): page_size Example: `100` - `partner` (string): Arrivals-by-region only: "total" (default: World / no partner dimension), "all" for every region of origin, or a UN Tourism region code (10000 Africa, 20000 Americas, 30000 East Asia and the Pacific, 40000 Europe, 50000 Middle East, 60000 South Asia, 70000 Other not classified). Example: `` - `year_from` (number): year_from Example: `1995` - `year_to` (number): year_to Example: `1995` Response schema example: ```json { "catalog_version": "2026-09-11", "complete": true, "count": 1, "countries_m49": [ 724 ], "files": [ { "changed_since_catalog": false, "edition": "12.2025", "etag": "97538b097e596a427f2967a2eaaf3630", "file_id": "inbound_expenditure", "release_label": "23 December 2025", "rows_in_file": 13987, "source_updated_at": "2026-01-02T13:06:42Z", "url": "https://pre-webunwto.s3.amazonaws.com/s3fs-public/2025-12/UN_Tourism_inbound_expenditure_12_2025.xlsx", "version_id": "htMhLThP8bDcgtu2mdezemsaX7fMlQUq" } ], "indicator_codes": [ "INBD_EXPD_BPAY_TOTL_VSTR" ], "license": "UN Tourism content is copyrighted. The free Key Tourism Statistics files are provided for non-commercial use with attribution (see the file's suggested citation); redistribution requires permission from UN Tourism. Terms: https://www.untourism.int/copyright", "next_cursor": null, "observed_at_ms": 1789084800000, "offset": 0, "page_size": 100, "records": [ { "area_kind": "country", "country": "Spain", "edition": "12.2025", "file_id": "inbound_expenditure", "flag": null, "flag_label": null, "id": "inbound_expenditure|INBD_EXPD_BPAY_TOTL_VSTR|724|999|2024", "indicator_code": "INBD_EXPD_BPAY_TOTL_VSTR", "indicator_name": "inbound - expenditure - balance of payments - total - visitors", "indicator_previous_code": "CP_1_33", "iso3": "ESP", "m49_code": 724, "notes": "Calculated as sum of the travel and passenger transport components", "observed_at_ms": 1789084800000, "partner_area": "World", "partner_area_code": 999, "provisional": false, "release_date": "2025-12-23", "series_note": "Calculated as sum of the travel and passenger transport components", "source": null, "source_file": "https://pre-webunwto.s3.amazonaws.com/s3fs-public/2025-12/UN_Tourism_inbound_expenditure_12_2025.xlsx", "source_updated_at": "2026-01-02T13:06:42Z", "source_url": "https://www.untourism.int/tourism-statistics/tourism-data-inbound-tourism", "unit": "million US dollars (nominal values)", "unit_note": "multiplier 1,000,000; currency USD; nominal (current) prices", "value": "106656.535197297", "value_number": 106656.535197297, "year": 2024 } ], "retrieved_at": "2026-09-11T00:00:00Z", "schema_version": "1.0.0", "source_updated_at": "2026-01-02T13:06:42Z", "total": 1, "warnings": [], "year_from": 2024, "year_to": 2024 } ``` ### Files - Capability: `statistics/files` - Description: The official UN Tourism Key Tourism Statistics Excel files (13 files: inbound arrivals/expenditure/by region/by purpose/by transport/accommodation, outbound departures/expenditure, domestic trips/accommodation, hotel capacity and occupancy, employment SDG 8.9.2, tourism GDP SDG 8.9.1). One live HEAD per file returns Last-Modified as source_updated_at, ETag and S3 version id, and changed_since_catalog flags a re-publication since the embedded catalogue. - Instructions: The official UN Tourism Key Tourism Statistics Excel files (13 files: inbound arrivals/expenditure/by region/by purpose/by transport/accommodation, outbound departures/expenditure, domestic trips/accommodation, hotel capacity and occupancy, employment SDG 8.9.2, tourism GDP SDG 8.9.1). One live HEAD per file returns Last-Modified as source_updated_at, ETag and S3 version id, and changed_since_catalog flags a re-publication since the embedded catalogue. - Cost: 5 credits per call - Capability file: [Files](https://firecrawl.dev/alexandria/agents/providers/untourism-int/statistics/files) Accepted options: - `file_ids` (string[]): Restrict to these file ids. Omit for all files. Example: `[]` - `series_group` (string): Restrict to one series group. Example: `inbound` Response schema example: ```json { "catalog_version": "2026-09-11", "complete": true, "count": 1, "database_page": "https://www.untourism.int/tourism-statistics/tourism-statistics-database", "license": "UN Tourism content is copyrighted. The free Key Tourism Statistics files are provided for non-commercial use with attribution (see the file's suggested citation); redistribution requires permission from UN Tourism. Terms: https://www.untourism.int/copyright", "next_cursor": null, "observed_at_ms": 1789084800000, "records": [ { "catalog_last_modified": "2026-07-17T12:04:21Z", "catalog_version_id": "yg4q8RqBEmpqmX52.NTcsmJ2VGsNTVe7", "changed_since_catalog": false, "citation": "World Tourism Organization (2026) All Countries: Inbound Tourism: Arrivals 1995 - 2024 (07.2026). UN Tourism Statistics Database, Madrid. Data updated on 17 July 2026. More information: https://www.untourism.int/tourism-statistics/tourism-data-inbound-tourism", "columns": [ "indicator_code", "indicator_label", "indicator_previous_code", "reporter_area_code", "reporter_area_label", "partner_area_code", "partner_area_label", "year", "value", "flag", "flag_label", "unit", "notes" ], "content": "All Countries: Inbound Tourism: Arrivals 1995 - 2024 (07.2026)", "content_length": 601529, "content_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "edition": "07.2026", "error": null, "etag": "9c0f4ab0a22baa6f3b45fce22e668698", "file_id": "inbound_arrivals", "indicator_count": 4, "observed_at_ms": 1789084800000, "page_url": "https://www.untourism.int/tourism-statistics/tourism-data-inbound-tourism", "release_date": "2026-07-17", "release_label": "17 July 2026", "row_count_at_catalog": 13774, "series_group": "inbound", "source_updated_at": "2026-07-17T12:04:21Z", "source_url": "https://pre-webunwto.s3.eu-west-1.amazonaws.com/s3fs-public/2026-07/UN_Tourism_inbound_arrivals_17_07_2026.xlsx", "status": 200, "title": "Inbound tourism: total arrivals (overnight, same-day, cruise)", "url": "https://pre-webunwto.s3.eu-west-1.amazonaws.com/s3fs-public/2026-07/UN_Tourism_inbound_arrivals_17_07_2026.xlsx", "version_id": "yg4q8RqBEmpqmX52.NTcsmJ2VGsNTVe7", "year_max": 2024, "year_min": 1995 } ], "retrieved_at": "2026-09-11T00:00:00Z", "schema_version": "1.0.0", "series_group": null, "source_updated_at": "2026-07-17T12:04:21Z", "warnings": [] } ``` ### Indicators - Capability: `statistics/indicators` - Description: Search the 148 free indicators (code, name, series group, unit, source file). `query` matches words in the code, name, previous Compendium code, unit, file id or common synonyms (receipts -> inbound expenditure, occupancy -> hotel room/bed rates); `series_group` narrows to inbound, outbound, domestic, industries, employment or macro. Cursor-paginated; each page carries the live publication date of its source files. - Instructions: Search the 148 free indicators (code, name, series group, unit, source file). `query` matches words in the code, name, previous Compendium code, unit, file id or common synonyms (receipts -> inbound expenditure, occupancy -> hotel room/bed rates); `series_group` narrows to inbound, outbound, domestic, industries, employment or macro. Cursor-paginated; each page carries the live publication date of its source files. - Cost: 5 credits per call - Capability file: [Indicators](https://firecrawl.dev/alexandria/agents/providers/untourism-int/statistics/indicators) Accepted options: - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `page_size` (number): page_size Example: `50` - `query` (string): Free-text filter: every word must appear in the code, name, legacy code, unit, file id or a built-in synonym (receipts, occupancy, region of origin, mode of transport, departures, nights, employment, tourism gdp); empty lists every indicator. Example: `` - `series_group` (string): series_group Example: `inbound` Response schema example: ```json { "catalog_version": "2026-09-11", "complete": true, "count": 1, "license": "UN Tourism content is copyrighted. The free Key Tourism Statistics files are provided for non-commercial use with attribution (see the file's suggested citation); redistribution requires permission from UN Tourism. Terms: https://www.untourism.int/copyright", "next_cursor": null, "observed_at_ms": 1789084800000, "offset": 0, "page_size": 50, "query": "inbd_trip_totl_totl_tour", "records": [ { "edition": "07.2026", "file_id": "inbound_arrivals", "has_partner_dimension": true, "indicator_code": "INBD_TRIP_TOTL_TOTL_TOUR", "name": "inbound - trips - total - total - overnight visitors (tourists)", "notes": "Previous database code CP_1_2. Has a partner (region of origin) dimension; filter with `partner`. Years 1995-2024 in edition 07.2026.", "observation_count_at_catalog": 5220, "observed_at_ms": 1789084800000, "page_url": "https://www.untourism.int/tourism-statistics/tourism-data-inbound-tourism", "previous_code": "CP_1_2", "series_group": "inbound", "source_updated_at": "2026-07-17T12:04:21Z", "source_url": "https://pre-webunwto.s3.eu-west-1.amazonaws.com/s3fs-public/2026-07/UN_Tourism_inbound_arrivals_17_07_2026.xlsx", "unit": "thousand trips", "unit_note": "multiplier 1,000; count of trips" } ], "retrieved_at": "2026-09-11T00:00:00Z", "schema_version": "1.0.0", "series_group": null, "source_updated_at": "2026-07-17T12:04:21Z", "total": 1, "warnings": [] } ```