v1
latestOpenAPI 3.1.02026-07-234140131.3 KBSearch and filter products
Query parameters
Only return products located in the defined city. Use the /cities endpoint to find the IDs Tiqets has assigned to the various known cities. Products 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.
Name of the city to filter by. Useful for debugging or certain use cases. We recommend using city_id instead.
Tiqets ID of the product country to filter by.
Name of the country to filter by. Useful for debugging or certain use cases. We recommend using country_id instead.
Currency code of the price components (ISO 4217).
Exclude products from the results if they belong to the specified city.
Exclude products from the results if they belong to the specified experience.
Language of the content to retrieve (ISO 639-1). Defaults to English if undefined.
Filters the result set by latitude. Requires a combination of latitude/longitude parameters. Also see max_distance.
Filters the result set by longitude. Requires a combination of latitude/longitude parameters. Also see max_distance.
Maximum distance in kilometers to filter results by. Value can be between 0 and 100; defaults to 5 if undefined.
Minimum rating of the product in customer reviews.
Number of items per page. Default value is 10, maximum value is 100.
Number of the page to retrieve. Used in combination with the page_size parameter to define the page size.
Textual query to find products that match the query. The results are ranked by internal calculation of relevancy which can change over time. Adding more keywords narrows down the results.
Define as true if you do not wish to include products that do not have a determined venue location. Defaults to false if undefined.
Sort by
- popularity
- price
- title
- distance (in combination with lat/lng)
- score (Search query matching score. Only in combination with the query parameter). Sort ascending (asc) or descending (desc).
ID of the tag to filter by. See tags endpoint. Repeat the tag_id parameter to broaden the search to include one or more of the provided tag IDs.
ID of the tag to exclude from results. Products associated with the specified tag will not be returned. Repeat the exclude_tag_id parameter to exclude products matching any of the provided tag IDs.
If true, only individual products are returned and package products are excluded from the results. Defaults to false if undefined.
ID of the experience to filter by. Experiences can be searched and retrieved using the dedicated Experiences endpoint.
Repeat the experience_id parameter to broaden the search to span multiple experiences.
Note that this parameter is not allowed together with venue_id that is deprecated.
ID of the experience to filter by. Experiences can be searched and retrieved using the dedicated Experiences endpoint.
Repeat the venue_id parameter to broaden the search to span multiple experiences.
Note that this parameter is deprecated and experience_id is recommended. If you specify this and experience_id, it will trigger an error.
Headers
Token <Your_API_Key>.
Response
Successful operation.