Documentation / Series / 41 of 107

Search series

GET/v1/series/search

Free-text search across series names in every language held, ranked by match and freshness.

Developer plan and upKey requiredJSON or CSVCached until the next release

Parameters

Name	Type	Description
qrequired	string query	Words to match in series names e.g. hotel nights foreign
countryoptional	string query	One or more ISO codes, comma separated e.g. CL,BA,AT
limitoptional	integer query	Rows per page, 1 to 1000 e.g. 100

Request

# Full-text search over two million series names
curl "https://api.tourismapi.com/v1/series/search?q=hotel nights foreign" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/series/search?q=hotel nights foreign", {
  headers: { "X-API-Key": process.env.TOURISM_API_KEY }
});
if (!res.ok) throw new Error(`Tourism API ${res.status}`);
const { meta, data } = await res.json();
console.log(meta.data_as_of, data);

import os, requests

r = requests.get(
    "https://api.tourismapi.com/v1/series/search?q=hotel nights foreign",
    headers={"X-API-Key": os.environ["TOURISM_API_KEY"]},
    timeout=10,
)
r.raise_for_status()
body = r.json()
print(body["meta"]["data_as_of"], body["data"])

$ch = curl_init("https://api.tourismapi.com/v1/series/search?q=hotel nights foreign");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["X-API-Key: " . getenv("TOURISM_API_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
print_r($body["data"]);

Your API key

Ready

Example response

{
    "meta": {
        "request_id": "req_80ea08050d",
        "data_as_of": "2026-11-07T04:51:45Z",
        "count": 25,
        "q": "hotel nights foreign",
        "searched": "every served series"
    },
    "data": [
        {
            "id": "sr_2efm01hs",
            "alias": null,
            "country": "NO",
            "name": "Hotels and similar establishments, Foreign national, total, Guest nights",
            "measure": "capacity",
            "breakdown": null,
            "freq": "M",
            "unit": "",
            "first": "2010-01",
            "last": "2019-12",
            "points": 120,
            "headline": false
        },
        {
            "id": "sr_yj47ah45",
            "alias": null,
            "country": "NO",
            "name": "Hotels and similar establishments, Foreign national, total, Guest nights so far this year",
            "measure": "capacity",
            "breakdown": null,
            "freq": "M",
            "unit": "",
            "first": "2010-01",
            "last": "2019-12",
            "points": 120,
            "headline": false
        },
        {
            "id": "sr_6fpa733j",
            "alias": null,
            "country": "SI",
            "name": "Type of municipalities - TOTAL, Hotels, Region of residence - TOTAL, Number of nights in Slovenia",
            "measure": "nights",
            "breakdown": null,
            "freq": "M",
            "unit": "",
            "first": "2009-01",
            "last": "2012-02",
            "points": 5,
            "headline": false
        }
    ]
}

Response fields

Field	Type	Example
id	string	sr_2efm01hs
alias	null	null
country	string	NO
name	string	Hotels and similar establishments, Foreign national, total, Guest nights
measure	string	capacity
breakdown	null	null
freq	string	M
unit	string
first	string	2010-01
last	string	2019-12
points	number	120
headline	boolean	false