This is the recommended method. The tracker key is included in the `token` parameter.

curl --location 'https://api.synerise.com/recommendations/v2/recommend/campaigns/DkhvrZoTKthD?token=98A5FC55-0000-0000-0000-98339BDECAE6&clientUUID=cf9e9b57-7776-51bc-b7bc-75cc75abdf59'
                                                                                              <-------------- tracker key ------------->

where: - `DkhvrZoTKthD` is an example campaign ID. You can also refer to a campaign by its slug. - `98A5FC55-0000-0000-0000-98339BDECAE6` is an example tracker key. - `cf9e9b57-7776-51bc-b7bc-75cc75abdf59` is an example profile UUID.

The JWT is included in the `Authorization` header.

curl --location 'https://api.synerise.com/recommendations/v2/recommend/campaigns/DkhvrZoTKthD?clientUUID=cf9e9b57-7776-51bc-b7bc-75cc75abdf59' \
--header 'Authorization: Bearer eyJhbGciOiJSUzUx.edWIiOiIyYzU2Yjk5NmR...g7ToscgR9au6fQDhbs'

where: - `DkhvrZoTKthD` is an example campaign ID. You can also refer to a campaign by its slug. - `cf9e9b57-7776-51bc-b7bc-75cc75abdf59` is an example profile UUID.

In GET requests, the item context is sent in the `itemId` attribute. In campaigns which accept multiple items in the context (cart recommendations), send the attribute multiple times. See example:

curl --location 'https://api.synerise.com/recommendations/v2/recommend/campaigns/DkhvrZoTKthD?itemId=0196499479257&itemId=0000301448594&itemId=0000301826378&token=98A5FC55-0000-0000-0000-98339BDECAE6&clientUUID=cf9e9b57-7776-51bc-b7bc-75cc75abdf59'

where: - `DkhvrZoTKthD` is an example campaign ID. You can also refer to a campaign by its slug. - `itemId=0196499479257&itemId=0000301448594&itemId=0000301826378` are 3 example items for context. The `itemId` parameter must be sent multiple times to include multiple items. If the campaign doesn't require an item context and you don't want to use it in filters, skip the `itemId` parameter entirely. - `98A5FC55-0000-0000-0000-98339BDECAE6` is an example tracker key. - `cf9e9b57-7776-51bc-b7bc-75cc75abdf59` is an example profile UUID.

curl --location 'https://api.synerise.com/recommendations/v2/recommend/campaigns?token=98A5FC55-0000-0000-0000-98339BDECAE6' \
--header 'Content-Type: application/json' \
--data '{
    "clientUUID": "cf9e9b57-7776-51bc-b7bc-75cc75abdf59",
    "campaignId": "DkhvrZoTKthD"
}'

This example shows an XHR request with error handling.

var xhr = new XMLHttpRequest();

// Add an event listener for 'readystatechange' to handle the response
xhr.addEventListener("readystatechange", function() {
  if(this.readyState === XMLHttpRequest.DONE) {
    if (this.status >= 200 && this.status < 300) {
      // Successful response
      console.log(this.responseText);
    } else {
      // Handle errors
      console.error('Request failed with status:', this.status, 'and response:', this.responseText);
    }
  }
});

// Open a GET request
xhr.open("GET", "https://api.synerise.com/recommendations/v2/recommend/campaigns/DkhvrZoTKthD?token=98A5FC55-0000-0000-0000-98339BDECAE6&clientUUID=cf9e9b57-7776-51bc-b7bc-75cc75abdf59", true);

// Send the request
xhr.send();

This request fetches a personalized recommendation without any item context or filters.

curl --location 'https://api.synerise.com/recommendations/v2/recommend/items/users/cf9e9b57-7776-51bc-b7bc-75cc75abdf59?token=98A5FC55-0000-0000-0000-98339BDECAE6'

where: - `cf9e9b57-7776-51bc-b7bc-75cc75abdf59` is an example profile UUID - `98A5FC55-0000-0000-0000-98339BDECAE6` is an example tracker key For more details, see [API Reference](https://developers.synerise.com/AIRecommendations/AIRecommendations.html#operation/RecommendForUserV2)

This request fetches a recommendation of complementary items for a cart. It lists two items (items in the cart) as the context and explicitly declares the catalog (if not declared, the catalog name is `default`)

curl --location 'https://api.synerise.com/recommendations/v2/recommend/items/complementary?clientUuid=cf9e9b57-7776-51bc-b7bc-75cc75abdf59&itemId=0000300395769&itemId=0000323544569&itemCatalogId=shoestore&token=98A5FC55-0000-0000-0000-98339BDECAE6&'

where: - `cf9e9b57-7776-51bc-b7bc-75cc75abdf59` is an example profile UUID - `itemId=0000300395769&itemId=0000323544569` are 2 example items for context (items in the cart) The `itemId` parameter must be sent multiple times to include multiple items. - `shoestore` is an example item catalog ID If the `itemCatalogId` parameter isn't included, it defaults to `default` - `98A5FC55-0000-0000-0000-98339BDECAE6` is an example tracker key For more details, see [API Reference](https://developers.synerise.com/AIRecommendations/AIRecommendations.html#operation/ComplementItems)