Rate Limiting

Request Limits

Each API has its own hourly quota.

  • Projects API: 300 calls per hour
  • Mentions Search API (Historical & Recent): 30 calls per hour
  • Export API (TBA)

Errors

Exceeding a limit results in HTTP 429 Too Many Requests status code.

$ curl -H 'X-API-KEY: your_secret_key_here' \
https://sentione.com/api/public/v2/projects

{"message":"Rate limit of requests for this endpoint has been reached. Maximum number of requests for this endpoint is 300. Limits will reset at 2025-05-19T15:00:00.000Z."}

X-Rate-Limits headers

Following headers are included in each response to indicate current limit usage for particular endpoint

x-rate-limit-limit: 30         # Limit of requests for particular API
x-rate-limit-reset: 1747666800 # Unix timestamp (seconds) when limits will reset
x-rate-limit-remaining: 0      # Remaining number of requests