The Affinity API sets a limit on the number of calls that a user can make per minute, and that all the users on an account can make per month. It also sets a reasonable limit on the number of concurrent requests it will support from an account at one time. Requests to both Affinity API versions will count toward the one pool of requests allowed for a user or account. Once a per-minute, monthly, or concurrent rate limit is hit, subsequent requests will return an error code of 429. We highly recommend designing your application to handle 429 errors.Documentation Index
Fetch the complete documentation index at: https://developer.affinity.co/llms.txt
Use this file to discover all available pages before exploring further.
Per-Minute Limits (User-Level)
To help protect our systems, API requests will be halted at 900 per user, per minute. We may also lower this limit on a temporary basis to manage API availability.Concurrent Request Limits (Account-Level)
To protect our systems and manage availability across customers, we set a reasonable limit on concurrent requests at the account level. Customers should not expect to hit this limit unless they are hitting the API with heavy operations from many concurrent threads at once.Monthly Plan Tier Limits (Account-Level)
The overall number of requests you can make per month will depend on your account’s plan tier. This monthly account-level limit resets at the end of each calendar month. Current rate limits by plan tier are:| Plan Tier | Calls Per Month |
|---|---|
| Essentials | None |
| Scale | 100k |
| Advanced | 100k |
| Enterprise | Unlimited* |
Rate Limit Headers
All API calls will return the following response headers with information about per-minute and monthly limits:| Header | Description |
|---|---|
| x-ratelimit-limit-user | Number of requests allowed per minute for the user |
| x-ratelimit-limit-user-remaining | Number of requests remaining for the user |
| x-ratelimit-limit-user-reset | Time in seconds before the limit resets for the user |
| x-ratelimit-limit-org | Number of requests allowed per month for the account |
| x-ratelimit-limit-org-remaining | Number of requests remaining for the account |
| x-ratelimit-limit-org-reset | Time in seconds before the limit resets for the account |