Rate Limits
Pieowl API request limits and how to handle them
Limits
| Endpoint group | Limit |
|---|---|
| Insights | 100 req / 10 seconds |
| Export | 100 req / 10 seconds |
| Manage | 20 req / 10 seconds |
Limits apply per client ID. A request without a client ID is counted against its IP address.
Track, Profile and Import endpoints have no rate limit.
Handling 429s
When you go over the limit, the API returns 429 Too Many Requests:
{
"status": 429,
"error": "Too Many Requests",
"message": "You have exceeded the rate limit for this endpoint."
}Wait for the 10-second window to reset, then retry. Exponential backoff works well.