Platform
Catalog and freshness metadata for the Agent Datasets platform.
Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.
GET/v1/platform/catalog
Platform Catalog
Return the data catalog: categories, datasets, licensing posture, and tool summaries.
Categories are always returned in full (small fixed list). Datasets are
paginated by (category, dataset) keyset cursor. Default limit 50, max
100; all current datasets fit on one default page. Pass
pagination.next_cursor as cursor to advance pages.
Each dataset row carries posture ("public" or "internal"),
redistributable flag, coverage description, cadence, live
freshness snapshot, and the MCP tools that serve it.
meta.source is "platform_catalog" (public posture) — public-surface
credentials receive 200; individual dataset rows may describe internal
sources but the catalog metadata itself is not restricted.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| limit | integer | No | 50 | min 1, max 100 | — |
| cursor | string | null | No | — | — | — |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/platform/catalog"Response
200 Successful Response · expand a branch to see its fields.
dataCatalogDatarequiredTop-level data object: always-complete category list + paginated datasets.
categoriesarray<CategoryEntry>required
- keystringrequired
- display_namestringrequired
- status"live" | "soon"required
- descriptionstringrequired
- exemptbooleanrequired
datasetsarray<DatasetEntry>required
- datasetstringrequired
- display_namestringrequired
- categorystringrequired
- source_tagstringrequired
- source_namestringrequired
- licensestringrequired
- posture"public" | "internal"required
- redistributablebooleanrequired
- coveragestringrequired
- cadencestringrequired
freshnessFreshnessSubobjectrequiredFreshness sub-object reusing the exact vocabulary from DatasetFreshness.
- statusstringrequired
- stalebooleanrequired
- status_reasonstringnullable
- last_refreshstring (date-time)nullable
- latest_as_ofstring (date-time)nullable
toolsarray<ToolSummary>required
- namestringrequired
- summarystringrequired
metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/platform/freshness
Platform Freshness
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| limit | integer | No | 50 | min 1, max 100 | — |
| cursor | string | null | No | — | — | — |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/platform/freshness"Response
200 Successful Response · expand a branch to see its fields.
dataPlatformFreshnessDatarequired
datasetsarray<DatasetFreshness>required
- datasetstringrequired
- display_namestringrequired
- categorystringrequired
- sourcestringrequired
- cadencestringrequired
- status"fresh" | "stale" | "never_ran" | "manual" | "live"required
- stalebooleanrequired
- status_reasonstringrequirednullable
- last_refreshstring (date-time)requirednullable
- latest_as_ofstring (date-time)requirednullable
- non_redistributablebooleanrequired
- toolsarray<string>required
- checked_atstring (date-time)required
metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable