/getyourguide/locations/search

curl --request POST \
  --url https://api.anysite.io/api/getyourguide/locations/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 50,
  "timeout": 300
}
'

[
  {
    "id": 123,
    "name": "<string>",
    "@type": "@get_your_guide_search_location",
    "type": "<string>",
    "sub_type": "<string>",
    "country": "<string>",
    "descriptor": "<string>",
    "url": "<string>",
    "alias": "<string>",
    "image": "<string>"
  }
]

/getyourguide

/getyourguide/locations/search

Resolve a keyword to GetYourGuide locations (cities, countries, regions, attractions, and points of interest). Returns a ranked list of matching locations with id, name, type (city, country, region, or point of interest), sub type, country, descriptor, location page url, alias (slug), and image. Use it to turn a free-text place name into a location id for further GetYourGuide lookups.

Price: 1 credit

💡 AI Hint: Resolve a place name to GetYourGuide locations. Set count to how many results you want. Each item has id (the GetYourGuide location id), name, type (city, country, area/region, or poi), sub_type (museum, island, tower, and similar), country, descriptor (e.g. ‘City in France’), url (location page), alias (slug), and image. The first result is usually the best match for the keyword.

POST

api

getyourguide

locations

/getyourguide/locations/search

curl --request POST \
  --url https://api.anysite.io/api/getyourguide/locations/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 50,
  "timeout": 300
}
'

[
  {
    "id": 123,
    "name": "<string>",
    "@type": "@get_your_guide_search_location",
    "type": "<string>",
    "sub_type": "<string>",
    "country": "<string>",
    "descriptor": "<string>",
    "url": "<string>",
    "alias": "<string>",
    "image": "<string>"
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

keyword

string

required

Search keyword — a city, country, region, attraction, or point of interest name

Minimum string length: 1

Examples:

"Paris"

"italy"

"Eiffel Tower"

count

integer

required

Max number of results to return

Required range: 1 <= x <= 100

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

integer

required

name

string

required

@type

string

default:@get_your_guide_search_location

type

string | null

sub_type

string | null

country

string | null

descriptor

string | null

url

string | null

alias

string | null

image

string | null

/getyourguide/locations /getyourguide/suppliers