> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.artlist.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.artlist.io/_mcp/server.

# 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](mailto: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.