# China Snapshot developer documentation

Searchable retained Chinese publications, public attention and indicator observations.

- [The retained record, over HTTP.](https://china-snapshot.com/docs/getting-started/overview.md): Search Chinese publications, follow public attention and add economic context—with retained history and traceable sources.
- [Your first request](https://china-snapshot.com/docs/getting-started/quickstart.md): Start anonymously. Add a Free key when you need its history and page allowances.
- [Onboard your agent](https://china-snapshot.com/docs/getting-started/onboard-your-agent.md): One prompt to discover the contract and make a successful first request.
- [Authentication and keys](https://china-snapshot.com/docs/getting-started/authentication.md): Anonymous reads, emailed Free keys and entitled research credentials.
- [Find records](https://china-snapshot.com/docs/guides/find-records.md): Filter the retained corpus using literal title and publisher matching.
- [Retrieve a record](https://china-snapshot.com/docs/guides/retrieve-record.md): Use an ID returned by the dataset rather than a fabricated example identifier.
- [Inspect historical observations](https://china-snapshot.com/docs/guides/observations.md): Distinguish another collection from a new publication or economic release.
- [Retrieve changes since your last check](https://china-snapshot.com/docs/guides/changes.md): Poll the documents change feed with since and continue with next_since.
- [Export to CSV with citations](https://china-snapshot.com/docs/guides/export-csv.md): One response is one page. Keep provenance columns in every export.
- [Track an export-control topic](https://china-snapshot.com/docs/guides/policy-topic.md): A worked collection-window query over the maintained export-controls topic, with the record's own new and revised labels.
- [Track public attention over time](https://china-snapshot.com/docs/guides/public-attention.md): Compare sampled list appearances within a platform, with collection gaps visible.
- [Use indicators as context](https://china-snapshot.com/docs/guides/indicators.md): Keep reference periods, first capture dates and collection times separate.
- [Documents, observations and revisions](https://china-snapshot.com/docs/data/documents.md): The current public contract and the boundaries of retained history.
- [Public attention](https://china-snapshot.com/docs/data/public-attention.md): Sampled hot-list observations, with source-specific ranks and heat.
- [Indicators](https://china-snapshot.com/docs/data/indicators.md): Raw captures and deduplicated release views answer different questions.
- [Coverage and gaps](https://china-snapshot.com/docs/data/coverage.md): Distinguish the advertised collection schedule from what was actually retained.
- [Field glossary](https://china-snapshot.com/docs/data/glossary.md): Clocks, identifiers, nulls and the meaning of a page response.
- [Schema versioning](https://china-snapshot.com/docs/data/schema-versioning.md): Payload schemas and API transport versions are separate contracts.
- [API reference](https://china-snapshot.com/docs/api/overview.md): Generated from the repository OpenAPI contract. Every documented operation is included.
- [Browse and export retained China records](https://china-snapshot.com/docs/api/browse-public-datasets.md): browsePublicDatasets · GET /api/datasets
- [Documents added or revised since a time](https://china-snapshot.com/docs/api/get-changes.md): getChanges · GET /api/changes
- [Catalog of indicator time series](https://china-snapshot.com/docs/api/list-series.md): listSeries · GET /api/series
- [One indicator as a clean time series](https://china-snapshot.com/docs/api/get-series.md): getSeries · GET /api/series/{series_id}
- [One official indicator, free](https://china-snapshot.com/docs/api/get-indicator.md): getIndicator · GET /api/indicators/{slug}.json
- [Current topics and shared cited-document edges. Connections do not establish causation.](https://china-snapshot.com/docs/api/list-public-topics.md): listPublicTopics · GET /data/topics/index.json
- [Current reading, cited evidence and available history. Revision numbers may have gaps.](https://china-snapshot.com/docs/api/get-public-topic.md): getPublicTopic · GET /data/topics/{slug}.json
- [Current reading as Markdown with dates, original citations and creator attribution.](https://china-snapshot.com/docs/api/get-public-topic-markdown.md): getPublicTopicMarkdown · GET /data/topics/{slug}.md
- [A retained publishable reading with its own citations and comparison to the previous available reading.](https://china-snapshot.com/docs/api/get-public-topic-revision.md): getPublicTopicRevision · GET /data/topics/{slug}/v{version}.json
- [A retained publishable reading as Markdown, with original citations.](https://china-snapshot.com/docs/api/get-public-topic-revision-markdown.md): getPublicTopicRevisionMarkdown · GET /data/topics/{slug}/v{version}.md
- [Fetch endpoints](https://china-snapshot.com/docs/api/get-endpoints-catalog.md): getEndpointsCatalog · GET /data/endpoints.json
- [Fetch daily_digest](https://china-snapshot.com/docs/api/get-daily-digest.md): getDailyDigest · GET /data/daily_digest.json
- [Fetch baselines](https://china-snapshot.com/docs/api/get-baselines.md): getBaselines · GET /data/baselines.json
- [Fetch forecasts/index](https://china-snapshot.com/docs/api/get-forecast-board.md): getForecastBoard · GET /data/forecasts/index.json
- [Fetch forecasts/track_record](https://china-snapshot.com/docs/api/get-forecast-track-record.md): getForecastTrackRecord · GET /data/forecasts/track_record.json
- [Fetch signal-packet](https://china-snapshot.com/docs/api/get-signal-packet.md): getSignalPacket · GET /data/signal-packet.json
- [Fetch the current briefing as Markdown](https://china-snapshot.com/docs/api/get-daily-digest-markdown.md): getDailyDigestMarkdown · GET /data/digest.md
- [The MCP server manifest](https://china-snapshot.com/docs/api/get-mcp-manifest.md): getMcpManifest · GET /.well-known/mcp.json
- [Catch-all for undocumented API routes](https://china-snapshot.com/docs/api/api-not-found.md): apiNotFound · GET /api/{path}
- [Catch-all for undocumented API routes (POST)](https://china-snapshot.com/docs/api/api-not-found-post.md): apiNotFoundPost · POST /api/{path}
- [Describe the Professional research API](https://china-snapshot.com/docs/api/research-discovery.md): researchDiscovery · GET /api/research
- [Run one Professional research operation](https://china-snapshot.com/docs/api/research-invoke.md): researchInvoke · POST /api/research
- [Describe the MCP Streamable HTTP endpoint](https://china-snapshot.com/docs/api/mcp-discovery.md): mcpDiscovery · GET /api/mcp
- [Send a JSON-RPC 2.0 message to the MCP endpoint](https://china-snapshot.com/docs/api/mcp-json-rpc.md): mcpJsonRpc · POST /api/mcp
- [Request a Free API key by email](https://china-snapshot.com/docs/api/request-api-key.md): requestApiKey · POST /api/key_signup
- [Replace a self-serve API key by emailed link](https://china-snapshot.com/docs/api/replace-api-key.md): replaceApiKey · POST /api/keys/replace
- [Revoke a self-serve API key by emailed link](https://china-snapshot.com/docs/api/revoke-api-key.md): revokeApiKey · POST /api/keys/revoke
- [Start the Pro subscription checkout](https://china-snapshot.com/docs/api/start-pro-checkout.md): startProCheckout · POST /api/checkout/pro
- [The developer portal](https://china-snapshot.com/docs/api/developer-portal.md): developerPortal · GET /developers
- [This OpenAPI document](https://china-snapshot.com/docs/api/get-open-api.md): getOpenApi · GET /openapi.json
- [Connect through MCP](https://china-snapshot.com/docs/mcp/overview.md): Remote research tools over Streamable HTTP, with an entitled Bearer credential.
- [Plans and limits](https://china-snapshot.com/docs/plans/limits.md): Generated from api/tiers.py, with separate public-data and research accounting.
- [Changelog and deprecation](https://china-snapshot.com/docs/resources/changelog.md): Documentation release notes and the implemented research-version retirement policy.
- [Support and status](https://china-snapshot.com/docs/resources/support-status.md): API availability, collection freshness and editorial publication are independent signals.

- [OpenAPI](https://china-snapshot.com/openapi.json)