/track/v2/projects/{projectToken}

The tracking API group is used for manipulating your customer and event properties or fetching a specific timestamp.

Please note that the API requests in the Tracking group should be used for real-time tracking rather than, e.g. big scheduled imports; as that causes a significant strain on the technical side.

IP based rate limits

🚧

Starting November 1st, 2021, requests to the Tracking API from a single IP address that are above the new rate limit will get a response HTTP 429 to retry later at a slower rate. The data from the limited IP address will be ignored. Incoming requests from other IP addresses will not be affected. The text below refers to this change, coming November 1st, 2021.

The default IP-based rate limit is set to 9 000 HTTP requests per minute per IP address (i.e. 150 RPS / IP). The actual limit can vary on different instances and will always be at least the above.

Requests to the Tracking API from a single IP address that are above this rate limit will get a response HTTP 429 Too Many Requests. This means you should retry the request(s) later with an Exponential backoff and send subsequent requests at a slower rate. The data that had been sent in a request with a response 429 will be ignored (i.e. not saved into the platform). Incoming data in requests from other IP addresses will not be affected.

The limits are designed to be high enough to ensure that no legitimate tracking use case will ever hit the limit. Because the limit applies at a single visitor level, even if you have millions of visitors on your site at the same time, it is highly unlikely you would hit the limit. If you think you might need a higher limit, please contact your CSM.