Get cross-sell recommendations

This endpoint will allow you to easily benefit from Tiqets cross-sell expertise.

Our data-powered algorithm can show you the best products to propose to a customer based on what they've already selected or done. Millions of multi-day trips with our products ensure our recommendations are relevant.

Read the implementation guideline for support: Increase order value and repeat purchases with recommendations.

Get product cross-sell options

get

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

/products/{product_id}/recommendations/cross-sell

Returns a list of product recommendations that can be cross-sold based on the given product ID.

Path parameters

product_idintegerRequired

The ID of the product to get alternatives for.

Query parameters

sort_bystring · enumOptional

Sorting criterion.

Default: balancedPossible values:

max_per_experienceintegerOptional

Maximum number of variations/options to show per specific museum/experience.

Default: 1Example: 1

exclude_product_idsinteger[]Optional

A comma-separated list of product IDs to exclude from results (e.g., products already in cart).

Example: [1001,1002]

product_tag_idsinteger[]Optional

Filter recommendations by specific tag IDs (e.g., "Guided tour").

Example: [5,12]

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

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful response.

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

/products/{product_id}/recommendations/cross-sell

HTTPcURLJavaScriptPython

GET /v2/products/{product_id}/recommendations/cross-sell HTTP/1.1
Host: api.tiqets.com
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "filters": {
    "exclude_product_ids": [
      1001
    ],
    "product_tag_ids": [
      5
    ],
    "max_per_experience": 1
  },
  "recommendations": [
    {
      "product_id": 67890,
      "title": "Louvre - Group tour",
      "image_url": "https://cdn.tiqets.com/louvre.jpg",
      "from_price": {
        "amount": 59.99,
        "currency": "USD"
      }
    },
    {
      "product_id": 54321,
      "title": "Louvre - Group tour (exhibition included)",
      "image_url": "https://cdn.tiqets.com/louvre.jpg",
      "from_price": {
        "amount": 79.99,
        "currency": "USD"
      }
    }
  ]
}