Search and filter experiences

The term experience describes a venue, activity, service, point of interest. Tickets for an experience are available through one or more products related to the experience.

This endpoint allows querying for experiences using several search parameters. Common use cases include the initial and periodic retrieval of experiences in a certain city or country, retrieving a list of popular experiences in a given location, or a free-text query.

Read more with our guide How to Find and Display Experiences Using the Tiqets API

Search and filter experiences

get

https://api-tiqt-test.steq.it/v2https://api.tiqets.com/v2

/experiences

Query parameters

city_idintegerOptional

Only return experiences located in the defined city. Use the /cities endpoint to find the IDs Tiqets has assigned to the various known cities. Experiences located in the surrounding area can also be returned, this depends on the configuration of each individual product.

Repeat the city_id parameter to broaden the search to span multiple cities.

Example: 113

country_idintegerOptional

Only return experiences located in the defined country. Use the [/countries]#tag/Content-API/paths/~1countries/get) endpoint to find the IDs Tiqets has assigned to the various known countries. Experiences located in the surrounding area can also be returned, this depends on the configuration of each individual product.

Repeat the country_id parameter to broaden the search to span multiple countries.

Example: 50233

typestring · enumOptional

Only return experiences with the defined type.

Example: activityPossible values:

currencystringOptional

Currency code of the price components (ISO 4217).

Default: EURExample: EUR

langstringOptional

Language of the content to retrieve (ISO 639-1). Defaults to English if undefined.

Default: enExample: en

page_sizeinteger · min: 1 · max: 100Optional

Number of items per page. Default value is 10, maximum value is 100.

Default: 10Example: 5

pageinteger · min: 1Optional

Number of the page to retrieve. Used in combination with the page_size parameter to define the page size.

Default: 1Example: 1

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful operation.

application/json

400

Bad Request -- Check your request parameters (typo in parameter or invalid value).

application/json

401

Unauthorized -- Your API key is incorrect.

application/json

403

Forbidden -- The endpoint or parameters are not allowed for the matching API key.

application/json

404

Not Found -- Requested resource/endpoint could not be found.

application/json

405

Method Not Allowed -- Check your request method.

application/json

429

Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.

application/json

500

Internal Server Error -- We had a problem with our server. Try again later.

application/json

503

Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

application/json

get

/experiences

HTTPcURLJavaScriptPython

GET /v2/experiences HTTP/1.1
Host: api-tiqt-test.steq.it
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "success": true,
  "pagination": {
    "total": 5,
    "page": 1,
    "page_size": 100
  },
  "experiences": [
    {
      "id": 211947,
      "type": "activity",
      "language": "en",
      "title": "Barcelona Hop-on Hop-off Tours",
      "experience_url": "https://www.tiqets.com/en/barcelona-hop-on-hop-off-tours-tickets-l211947/",
      "images": {
        "small": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=128&ixlib=python-4.0.0&q=70&w=128",
        "medium": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=250&ixlib=python-4.0.0&q=70&w=250",
        "large": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=500&ixlib=python-4.0.0&q=70&w=500",
        "extra_large": "https://aws-tiqets-cdn.imgix.net/images/content/3a740f66b9664886b391b042f442edde.jpg?auto=format%2Ccompress&fit=crop&h=1284&ixlib=python-4.0.0&q=70&w=1284",
        "credits": "",
        "alt_text": "People riding an open-top tour bus along a coastal promenade lined with palm trees, with buildings and the sea in the background."
      },
      "address": {
        "street": null,
        "postal_code": null,
        "city_id": 66342,
        "city_name": "Barcelona",
        "country_id": 50067,
        "country_name": "Spain",
        "latitude": 41.387397,
        "longitude": 2.168568,
        "google_place_id": null
      },
      "ratings": {
        "total": 15381,
        "average": 4.3
      },
      "currency": "EUR",
      "from_price": 22,
      "tagline": "Explore all the highlights of Barcelona at your own pace",
      "description": "Ditch the walking tours and set itineraries and explore Barcelona your way with these city bus tour selections. \nGet to know Barcelona the easy way with a convenient hop-on hop-off bus tour around the city. See Barcelona's best sights at your own pace with guided narration in multiple languages onboard. \nSpeed over to Sagrada Familia, cruise to Casa Mila, and check out Plaça de Catalunya (and so much more) all on the same day with a hop-on hop-off option.\nLooking to beat the heat (and the crowds)? Opt for a night bus tour around Barcelona to see the city in a different light. Or, pick your own route with a public transport card (and save your soles).",
      "tag_ids": [
        1041
      ],
      "product_ids": [
        974325,
        1029217,
        1032090,
        1098213,
        1114753,
        1116576
      ]
    }
  ]
}