Get Started

General Terms

Quota

The API quota is allocated per client and managed by your Primer account manager.
If you’re unsure of your current quota, contact Support at enterprise-api-support@artlist.io or reach out to your Primer account manager.
Quotas will soon be visible in the developer portal.

Rate Limit

To maintain service stability and ensure fair usage, the Artlist API enforces rate limiting.

Standard Limits

  • Request quota : 100 requests per minute
  • Time window : Rolling 60-second window
  • Reset period : Limits reset automatically at the start of each new window

Endpoint-Specific Limits

/search: 50 requests per minute
/download: 20 requests per minute

Rate-Limit Response

When exceeded, the API will return status code: 429 Too Many Requests

Headers:

X-RateLimit-Limit: Total requests allowed
X-RateLimit-Remaining: Requests remaining
X-RateLimit-Reset: Time until limit resets (in seconds)

Best Practices

  • Implement exponential backoff when rate limits are reached.
  • Monitor rate limit headers in API responses.
  • Contact Support for temporary limit increases.