Skip to content

Affiliate ids and clickouts

Every offer the API returns has a clickout URL: link on GET /v1/Products/{id}/Prices and clickoutUrl on GET /v1/Shops/{shopId}/Offers. When a user clicks it, they go through our tracking to the shop. The URL carries your affiliate id, so the click and any resulting sale are attributed to you.

An affiliate id is a code registered on your key, for example 000000000000000000000000ABCD0001. A key can have several, typically one per website or app you run.

  • Without AffiliateId, the API uses the first affiliate id registered on your key.
  • With AffiliateId, the API uses that one. It must be registered on your key, otherwise you get 400 Bad Request.

AffiliateId is accepted by GET /v1/Products, GET /v1/Products/{id}, GET /v1/Products/{id}/Prices and GET /v1/Shops/{shopId}/Offers.

Terminal window
curl -s "https://productapiext.reshift.nl/v1/Products/{id}/Prices?AffiliateId=000000000000000000000000ABCD0002" \
-H "Authorization: $RESHIFT_API_KEY"

Clicks and sales are reported per affiliate id. If two of your sites share one id, we cannot tell them apart, and neither can you. Ask us for an extra id when you add a site; it is added to your existing key.

  • Use the link unchanged. Don’t shorten it, strip parameters or rebuild it. Changing it breaks attribution.
  • Only real user clicks. Don’t prefetch, crawl or health-check clickout links. Automated clicks are filtered out and don’t count, and they make your click reports harder to read.
  • Don’t store links for long. Prices and links change throughout the day. Fetch the prices again when you show them, rather than storing them for days.
  • Open the link in the user’s browser. The tracking relies on a normal browser redirect to the shop.