Discover the API Surface
GET /api/public/v1 lists endpoints, parameters, fields, rate limits and example URLs.
The discovery root describes the API without requiring the documentation page. One GET returns endpoints, parameters, response shapes, rate limits and working example URLs.
Who This Is For
- Developers exploring the API for the first time without reading the docs
- AI agents (Claude, ChatGPT, Cursor) that need to discover capabilities at runtime
- OpenAPI / SDK generators that emit typed clients from a machine-readable spec
Common Scenarios
- 01
Bootstrap an AI Agent
Fetch /api/public/v1 when an agent starts to describe available endpoints.
- 02
Generate a Typed Client
Generate TypeScript or Python clients from parameter names and response types.
- 03
Programmatic Capability Checks
Check the discovery payload before calling a potentially unavailable endpoint.
Endpoints
GET
/Self-describing JSON: every endpoint, parameter, response field, rate limit and worked example.
GET / · Requestcurl "https://datreal.com/api/public/v1"
Frequently Asked Questions
Is this an OpenAPI spec?
It is not OpenAPI 3.x. The payload contains the information needed to generate it.Will this stay backwards-compatible?
The shape is part of the stable public API contract. New fields are additive.Where's the MCP server?
See /api-docs#mcp-server for the MCP server. Use discovery when building your own client.
Let Your AI Agent Discover the API
One GET. Whole surface as JSON. No docs page required.
