API Usage Policy
Plans
|------|-------------|-------------|--------------|
Contact sales@buyorsell24.com for pricing details.
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: support@buyorsell24.com