# Docs

> Everything about calling okdata: quickstart, request and response format, paging, errors, the five shared objects and the MCP server.

Canonical page: https://okdata.online/docs/

Start with the quickstart; everything else is reference.

- [Quickstart](https://okdata.online/docs/quickstart/): Get a key, make one call to Xiaohongshu note search, read the data and the bill, then fetch the next page. About two minutes.
- [Requests](https://okdata.online/docs/requests/): How every okdata call is shaped: paths, auth, the response envelope, paging with cursors, view and fields to trim output, and idempotent retries.
- [MCP](https://okdata.online/mcp/): Connect any MCP client to okdata over Streamable HTTP: one URL, one header, three tools. Agents find an endpoint, check its price and call it.
- [Errors](https://okdata.online/docs/errors/)

## Objects

- [Post](https://okdata.online/docs/objects/post/): A video, note, tweet or article, the same shape on every platform.
- [Account](https://okdata.online/docs/objects/account/): A creator, brand or person.
- [Comment](https://okdata.online/docs/objects/comment/): A comment or reply under a post.
- [Trend](https://okdata.online/docs/objects/trend/): One row of a hot search or trending board.
- [Transcript](https://okdata.online/docs/objects/transcript/): Timed text of a video.

## Machine-readable

- MCP: `https://api.okdata.online/mcp`
- llms.txt: https://okdata.online/llms.txt
- llms-full.txt: https://okdata.online/llms-full.txt
- agents.md: https://okdata.online/agents.md
- OpenAPI 3.1: https://okdata.online/openapi.json
- prices.json: https://okdata.online/prices.json
- API catalog (RFC 9727): https://okdata.online/.well-known/api-catalog
- Every page has a Markdown twin: add .md to its path.