{"ok":true,"site":"catalog-data","host":"catalog.data.gov","about":"catalog.data.gov is the U.S. government's open-data catalog (about 587k datasets from federal, state and local publishers). This CLI searches datasets, pages through results, reads dataset metadata and download links, fetches raw DCAT records, and lists organizations, publishers and keywords.","commands":[{"command":"search-datasets","summary":"Search the Data.gov catalog for datasets, with optional keyword tag, organization type, publisher, geospatial and downloadable-file filters, and sorting.","params":[{"name":"q","type":"string","description":"Free-text search query"},{"name":"sort","type":"string","description":"Sort order: relevance, popularity or last_harvested_date. The UI also offers a fourth option (likely distance), which was not tested.","default":"relevance"},{"name":"keyword","type":"string","description":"Exact keyword tag filter, e.g. 'ev' or 'powerball'. Use suggest-keywords to find valid tags."},{"name":"org_type","type":"string","description":"Organization type filter, e.g. 'Federal Government' or 'State Government'. Values match organization_type in list-organizations."},{"name":"publisher","type":"string","description":"Exact publisher name. Use list-publishers to find names."},{"name":"spatial_filter","type":"string","description":"Restrict to geospatial or non-geospatial datasets. Leave unset for all.","oneOf":["geospatial","non-geospatial"]},{"name":"has_download","type":"boolean","description":"true = only datasets with a downloadable file"}],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/search-datasets?q=electric+vehicles&sort=relevance&keyword=ev&org_type=State+Government&publisher=National+Renewable+Energy+Laboratory+%28NREL%29&has_download=true"},{"command":"search-datasets-next","summary":"Fetch the next page of dataset search results (the 'Show more results' fragment) using an 'after' cursor from a previous results page.","params":[{"name":"after","type":"string","required":true,"description":"Opaque base64 cursor taken from the previous results page's 'Show more results' link"},{"name":"q","type":"string","description":"The same search query as the original search"},{"name":"sort","type":"string","description":"The same sort as the original search: relevance, popularity or last_harvested_date","default":"relevance"},{"name":"keyword","type":"string","description":"The same keyword tag filter as the original search"},{"name":"org_type","type":"string","description":"The same organization type filter as the original search"},{"name":"publisher","type":"string","description":"The same publisher filter as the original search"},{"name":"spatial_filter","type":"string","description":"The same geospatial filter as the original search","oneOf":["geospatial","non-geospatial"]},{"name":"has_download","type":"boolean","description":"The same downloadable-file filter as the original search"},{"name":"per_page","type":"number","description":"Results per page","default":20},{"name":"results","type":"number","description":"Number of results already shown, used for rank numbering, e.g. 40"}],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/search-datasets-next?after=WzEwNS45NDY5LDQsImYyYjIxZTJkLWY0OGUtNDg5ZC04OWI1LWU1NTAzZjI3YmYxNSJd&q=water+quality&sort=relevance&has_download=true&results=40"},{"command":"get-dataset","summary":"Get one dataset's metadata (title, description, publisher, dates, license, keywords) and its download links (distribution) by slug.","params":[{"name":"slug","type":"string","required":true,"description":"Dataset slug: the last part of a /dataset/<slug> URL, without any ?from_hint=... suffix"}],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/get-dataset"},{"command":"get-harvest-record","summary":"Get the raw DCAT JSON metadata record for a dataset by its harvest record UUID (linked from the dataset page).","params":[{"name":"id","type":"string","required":true,"description":"Harvest record UUID"}],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/get-harvest-record"},{"command":"list-organizations","summary":"List all publishing organizations (124) with slug, type and dataset count, as JSON.","params":[],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/list-organizations"},{"command":"list-publishers","summary":"List the top publishers by dataset count (100 of 1867); names can be used as the publisher filter.","params":[],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/list-publishers"},{"command":"suggest-keywords","summary":"Autocomplete keyword tags matching a partial string, with dataset counts; results can be used as the keyword filter.","params":[{"name":"search","type":"string","required":true,"description":"Partial keyword text"},{"name":"size","type":"number","description":"Maximum number of suggestions","default":10}],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/suggest-keywords?search=charg&size=10"},{"command":"search-organizations","summary":"Browse or search organizations by name (HTML listing with type and dataset count, paginated).","params":[{"name":"q","type":"string","description":"Organization name search text"},{"name":"per_page","type":"number","description":"Organizations per page","default":24},{"name":"page","type":"number","description":"Page number, starting at 1"}],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/search-organizations?q=energy"},{"command":"get-organization-datasets","summary":"List or search the datasets of one organization (by slug), with optional publisher and geospatial filters and sorting.","params":[{"name":"slug","type":"string","required":true,"description":"Organization slug, e.g. energy, census, noaa, washington (see list-organizations)"},{"name":"q","type":"string","description":"Search text within this organization's datasets"},{"name":"sort","type":"string","description":"Sort order: relevance, popularity or last_harvested_date","default":"relevance"},{"name":"publisher","type":"string","description":"Exact publisher name within the organization"},{"name":"spatial_filter","type":"string","description":"Restrict to geospatial or non-geospatial datasets","oneOf":["geospatial","non-geospatial"]}],"exampleUrl":"https://clify-dev.netlify.app/catalog-data/get-organization-datasets?q=solar&sort=relevance&publisher=National+Renewable+Energy+Laboratory+%28NREL%29"}]}