Provenance
Freshness & coverage
Methods (6)
searchDatasets
readSearch the CDP open-data catalog by keyword (CDP-scoped)
Input schema
{ "type": "object", "properties": { "q": { "type": "string", "examples": [ "emissions" ] }, "limit": { "type": "number", "examples": [ 20 ] } }, "additionalProperties": false }Optional q; limit caps 1000; search is pinned to CDP datasets only.
getDatasetSchema
readColumns + metadata for a dataset (Socrata view) (CDP Climate Disclosure).
Input schema
{ "type": "object", "properties": { "datasetId": { "type": "string", "examples": [ "ba5i-42qf" ] } }, "additionalProperties": false }datasetId required; returns view metadata and column schemas.
queryDataset
readSoQL query of a dataset’s rows
Input schema
{ "type": "object", "properties": { "datasetId": { "type": "string", "examples": [ "ba5i-42qf" ] }, "select": { "type": "string", "examples": [ "organization_name,city,country" ] }, "where": { "type": "string", "examples": [ "country='Bangladesh'" ] }, "order": { "type": "string" }, "limit": { "type": "number", "examples": [ 50 ] }, "offset": { "type": "number" } }, "additionalProperties": false }datasetId required; supports SoQL and paging; numeric/date values are strings.
countRows
readcount(*) over a dataset, optionally filtered
Input schema
{ "type": "object", "properties": { "datasetId": { "type": "string", "examples": [ "ba5i-42qf" ] }, "where": { "type": "string", "examples": [ "country='United States of America'" ] } }, "additionalProperties": false }datasetId required; optional where; returns a numeric count.
fullTextSearch
readSocrata $q full-text search within a dataset
Input schema
{ "type": "object", "properties": { "datasetId": { "type": "string", "examples": [ "ba5i-42qf" ] }, "q": { "type": "string", "examples": [ "London" ] }, "limit": { "type": "number", "examples": [ 50 ] } }, "additionalProperties": false }datasetId and q required; limit defaults 50 and caps 1000.
getServiceInfo
readStatic overview — catalog→query flow, search_context requirement, SoQL params, known dataset IDs
Input schema
{ "type": "object", "properties": {}, "additionalProperties": false }
