API Usage Policy
Plans
| Plan | Price | API Calls/mo | Rate Limit | AI Calls/mo |
|---|
| Free | $0 | 1,000 | 10 req/min | 0 |
| Startup Lite | $149/mo | 10,000 | 200 req/min | Included |
| Startup Growth | $299/mo | 50,000 | 500 req/min | 200 |
| Enterprise | Custom | 100,000+ | 1,000 req/min | 9,999 |
See [Features & Pricing](/features) for full comparison.
Rate Limits
Rate limits are enforced per-minute using a token bucket algorithm.
Quotas
- Monthly API call quotas reset on the 1st of each month (UTC)
- AI call quotas reset monthly
- Unused quota does not roll over
Authentication
All requests must include a valid API key in the Authorization header:
Authorization: Bearer bos24_...
Requests without valid authentication receive HTTP 401.
Response Format
All responses are JSON. Paginated endpoints return:
{
"data": [...],
"total": 1234,
"page": 1,
"per_page": 20,
"total_pages": 62
}
Caching
- Clients may cache responses for up to 5 minutes
- Do not cache error responses (4xx, 5xx)
- Use ETags or Last-Modified headers where provided
Bulk Access
- Do not use the API to download and store entire datasets
- Maximum 1,000 records per request via pagination
- Contact us for bulk data access arrangements
Prohibited Activities
- Sharing API keys with third parties
- Attempting to bypass rate limits
- Using automated tools to extract data at scale
- Reverse engineering the API or database
- Reselling raw API data without permission
- Using data for spam or unsolicited communications
Monitoring
We monitor API usage for:
- Rate limit compliance
- Abuse detection
- Performance optimization
- Security incidents
Suspension
We may suspend API access for:
- Exceeding rate limits persistently
- Violating acceptable use policies
- Suspected security breaches
- Non-payment of subscription fees
Contact
For API usage questions: [email protected]