China SnapshotDocs
Get a key ↗
Open in AI ↗
Open in ChatGPTOpen in ClaudeView Markdown
Plans and limits

Plans and limits

Generated from api/tiers.py, with separate public-data and research accounting.

Public-data tiers#

TierMonthly priceRequests/minRequests/monthRows/pageHistoryKeys
AnonymousUSD 060No configured cap100400 days0
Free keyUSD 0605000500730 days1
ProUSD 493001000005000Full retained archive3
TeamContact600No configured cap5000Full retained archive10

These are build-time configured values. Runtime overrides and the limits returned by your actual response take precedence. Team is the contact tier: it has no list price, and its limits above are the configured defaults for an agreement. History limits describe access to retained records, not a promise that every source goes back that far.

How usage is counted#

A keyed public-data request consumes one metered request during admission, before dataset query validation and retrieval. It is not counted per returned row. CSV is one page and one request, subject to the same page ceiling. Anonymous usage has no per-key monthly ledger. Inspect your own usage with GET /api/usage and a Bearer key.

Research and MCP#

The Pro research allowance is 5,000 combined research API and MCP tool calls per calendar month, separate from the public-data allowance. Read discovery for transport-specific throttles. MCP protocol initialization is not a metered tools/call.

When throttled#

Use response headers, especially Retry-After and the rate-limit fields. A monthly limit can require waiting until the next calendar reset, not a rapid retry loop. Never retry billing or signup blindly. Error guidance explains which failures are retryable.

Search documentation