Search a portal catalog
Discovery API search against a single portal via api/catalog/v1. Free-text query across titles and descriptions, with optional filters on type (only=dataset|chart|map|filter|story), categories, and tags. Responses include resultSetSize (total matches) and results (page of catalog rows). Page with limit (1-1000) and offset.
Path parameters
Portal slug (e.g. nyc, chicago, cdc).
Portal slug (e.g. nyc, chicago, cdc).
Query parameters
Free-text search across dataset titles and descriptions.
Free-text search across dataset titles and descriptions.
Page size (1-1000).
Page size (1-1000).
Page offset for pagination.
Page offset for pagination.
Type filter (dataset, chart, map, filter, story).
Type filter (dataset, chart, map, filter, story).
Comma-separated categories filter (see /categories for the portal list).
Comma-separated categories filter (see /categories for the portal list).
Comma-separated tags filter.
Comma-separated tags filter.
Response
Matching catalog rows with upstream total count.
Example response
{
"data": {
"portal": "nyc",
"domain": "data.cityofnewyork.us"
},
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}