Skip to main content
Captain Data implements rate limits to ensure fair usage and optimal performance for all users. Understanding these limits helps you design efficient automations and avoid interruptions.

Overview

Rate limits are applied at multiple levels:
  • API Endpoints: Per-minute limits on specific API calls
  • Daily Quotas: Total daily usage limits based on your plan
Each plan includes a daily quota that represents your total usage allowance. This quota is consumed by all API calls across your workspace.

Plan Tiers

Your rate limits are determined by your plan tier, which is based on your monthly credit allocation:
Plan TierMonthly CreditsDescription
TrialUp to 1,000Free trial with basic limits
Bronze1 - 10,000Starter plans for small teams
Silver10,001 - 100,000Growing teams and businesses
Gold100,001 - 500,000Scaling businesses
Platinum500,001 - 2,000,000High-volume operations
Diamond2,000,001 - 20,000,000Large-scale enterprise
Titanium20,000,001 - 50,000,000Maximum enterprise scale
Check your subscription page in Captain Data to see your current plan tier and monthly credit allocation.

API Rate Limits

Real-time Operations

The most important rate limits apply to API real-time operation execution. These limits determine how many requests you can make per minute:
Plan TierMax Requests/SecondMax Requests/Minute
Trial160
Bronze2120
Silver10600
Gold10600
Platinum201,200
Diamond201,200
Titanium402,400

Capacity Examples

Assuming an average request duration of 2-3 seconds:
Plan TierEstimated Daily CapacityExample Use Case
Trial~86,400 requests/daySmall-scale testing
Bronze~172,800 requests/dayIndividual prospecting
Silver / Gold~864,000 requests/dayTeam sales operations
Platinum / Diamond~1,728,000 requests/dayLarge-scale enrichment
Titanium~3,456,000 requests/dayEnterprise automation
Example: With a Silver or Gold tier plan (600 requests/minute), you can:
  • Enrich ~864,000 people profiles per day
  • Process ~36,000 profiles per hour
  • Handle ~600 concurrent enrichment requests

Quotas

Rate limits for quota and billing data retrieval via /quotas:
Plan TierMax Requests/SecondMax Requests/Minute
Trial< 15
Bronze< 110
Silver150
Gold150
Platinum175
Diamond175
Titanium2100

Best Practices

Optimizing for Rate Limits

  1. Implement Exponential Backoff: When you hit rate limits, wait before retrying with increasing delays.
  2. Monitor Your Usage: Track your API consumption to stay within limits.

Handling Rate Limit Errors

When you exceed rate limits, you’ll receive a 429 Too Many Requests response.
{
  "error": {
    "code": 429,
    "status": "Too Many Requests",
    "details": {
      "Retry-After": "60",
      "X-RateLimit-Limit": "2",
      "X-RateLimit-Reset": "1754402101",
      "X-RateLimit-Type": "/v1/people/enrich"
    },
    "message": "Rate limit exceeded (/v1/people/enrich)"
  }
}
This rate limit error response uses a different structure than our standard error format. For details on our typical error responses, see our FAQ and Troubleshooting guide.

Plan-Specific Considerations

Trial & Bronze

  • Focus on development and testing
  • Monitor usage closely to avoid interruptions

Silver & Gold

  • Suitable for production workloads
  • Great for growing teams and scaling operations
  • Consider upgrading for higher volume needs

Platinum & Diamond

  • Built for high-volume production workloads
  • Ideal for large-scale enrichment and automation

Titanium

  • Designed for enterprise-scale operations
  • Maximum concurrent execution capabilities
  • Contact support for custom limits if needed

Monitoring and Alerts

Track your rate limit usage through:
  • API response headers
  • Dashboard analytics
  • Webhook notifications for quota warnings

Getting Help

If you consistently hit rate limits or need higher limits:
  1. Review your implementation design for optimization opportunities
  2. Consider upgrading your plan for higher limits
  3. Contact support for custom enterprise solutions
For detailed information about your current plan’s limits, check your workspace dashboard or contact our support team.