Rate Limits

Rate Limiting

To protect system stability, rate limiting is applied to search and read endpoints that explicitly or implicitly trigger SHACL shape or SPARQL queries:

  • GET /v2/kg/things/{id}
  • GET /v2/kg/things
  • POST /v2/kg/things
  • GET /v1/kg/sparql
  • POST /v1/kg/sparql

Limits (per API key):

  • 10 requests per second
  • 100 requests per minute
  • 1,000 requests per hour
  • 10,000 requests per day

When a rate limit is exceeded, the API responds with HTTP 429 (Too Many Requests). The response includes the remaining time until the subsequent request is allowed. Requests that hit the limit are discarded and not counted toward usage.

To avoid hitting rate limits, clients should implement request throttling and smooth out request bursts.