v1

Finds destinations, parks, rides, shows, restaurants and hotels by name. Matching ignores case, accents, apostrophes and punctuation and forgives small typos, so spce mountin finds Space Mountain. Results come best first; match says how each one matched, entityType and attractionType say what it is (a ride, a show, a meet-and-greet), and park and destination say where it is (destination also carries its country and region), because many rides share a name. Narrow with types, parkId or destinationId; hasMore says whether more matched than were returned. Take an id from a result and call GET /v1/entity/{id}/live for what it is doing now. Put a park, resort or place in the term to narrow it (dumbo magic kingdom, tornado six flags, space mountain florida, carousel in minnesota), ask it the way you would say it (wait time for space mountain), or use wdw, dlr, dlp and tdr for the four Disney resorts. The term needs at least 3 letters or digits (2 for Chinese, Japanese and Korean), at most 6 words not counting filler such as the, for and wait, and no other parameters are accepted. Cached for up to an hour; a new entity can take that long to appear. Send the term trimmed and in lower case, with only the parameters you need, so that identical searches share a cache entry.

get/v1/search

Request

  • Base URL
    https://api.themeparks.wiki
  • URL
    https://api.themeparks.wiki/v1/search
  • Auth
    • none
    • or API key in header X-API-Key

Query parameters

qstring required

What to look for: part of a name, in any case, with or without accents, apostrophes or punctuation. At least 3 letters or digits (2 for Chinese, Japanese or Korean), at most 100 characters and 6 words. Small typos are forgiven.

typesstring

Only return these entity types, comma-separated: DESTINATION, PARK, ATTRACTION, SHOW, RESTAURANT, HOTEL. Default is all of them.

limitinteger

How many results to return, 1 to 25. Default 10.

parkIdstring

Only return things inside this park (the id of a PARK entity).

destinationIdstring

Only return things inside this destination (the id of a DESTINATION entity).

Response

Successful response

querystring required

The search term, as received and trimmed.

hasMoreboolean required

True when more matched than were returned. Narrow the search with a longer term, types, parkId or destinationId.

Changes