{"ok":true,"site":"ons","host":"ons.gov.uk","about":"Office for National Statistics (ons.gov.uk), the UK's official statistics site. This CLI searches publications and data, reads time series values and metadata, bulletins, datasets and the release calendar, and downloads CSV data. It is read-only and needs no login.","commands":[{"command":"search","summary":"Site-wide keyword search over ONS publications, bulletins, time series and datasets, with content-type and census topic filters, sorting and paging","params":[{"name":"q","type":"string","required":true,"description":"Search keywords"},{"name":"filter","type":"string","description":"Content type filter. Examples: publications, bulletin, time_series, datasets, user_requested_data. The UI repeats this param when several are chosen."},{"name":"topics","type":"string","description":"Comma-separated census topic ids, e.g. 7779 (Census), 9731 (Ageing), 6646 (Demography)"},{"name":"sort","type":"string","description":"Sort order","oneOf":["relevance","release_date","title"],"default":"relevance"},{"name":"page","type":"number","description":"Results page number (10 per page)","default":1}],"exampleUrl":"https://clify-dev.netlify.app/ons/search?q=inflation&filter=time_series"},{"command":"search-timeseries","summary":"Search the time series explorer (58k+ series) by keyword and/or topic path; each result shows the series ID (CDID) and dataset ID","params":[{"name":"q","type":"string","description":"Search keywords"},{"name":"topic","type":"string","description":"Restrict to a topic's time series, e.g. /economy/inflationandpriceindices/timeseries"},{"name":"sort","type":"string","description":"Sort order","oneOf":["relevance","release_date","title"]},{"name":"page","type":"number","description":"Results page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/ons/search-timeseries?q=unemployment"},{"command":"get-timeseries","summary":"Get time series metadata and its latest value (title, CDID, unit, latest period and value, release dates, source dataset) from the ONS content API","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash, e.g. economy/inflationandpriceindices or employmentandlabourmarket/peoplenotinwork/unemployment. Take it from a search-timeseries result URL."},{"name":"series_id","type":"string","required":true,"description":"Series ID (CDID), lowercase, e.g. l55o, d7g7, mgsx"},{"name":"dataset","type":"string","required":true,"description":"Source dataset ID, lowercase, e.g. mm23, lms"}],"exampleUrl":"https://clify-dev.netlify.app/ons/get-timeseries"},{"command":"get-timeseries-data","summary":"Get the monthly observations of a time series as a list of {date, value} (for quarterly or annual-only series use download-timeseries-csv)","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash, e.g. economy/inflationandpriceindices"},{"name":"series_id","type":"string","required":true,"description":"Series ID (CDID), lowercase"},{"name":"dataset","type":"string","required":true,"description":"Source dataset ID, lowercase"}],"exampleUrl":"https://clify-dev.netlify.app/ons/get-timeseries-data"},{"command":"download-timeseries-csv","summary":"Download a time series as CSV with all frequencies (annual, quarterly, monthly) plus metadata rows; also works for a previous version","params":[{"name":"uri","type":"string","required":true,"description":"Time series URI path, e.g. /economy/inflationandpriceindices/timeseries/l55o/mm23. Append /previous/vN for a superseded version."}],"exampleUrl":"https://clify-dev.netlify.app/ons/download-timeseries-csv?uri=%2Feconomy%2Finflationandpriceindices%2Ftimeseries%2Fl55o%2Fmm23"},{"command":"list-timeseries-versions","summary":"List previous (superseded) versions of a time series with update date, label/reason and version uri (pass uri to download-timeseries-csv)","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"},{"name":"series_id","type":"string","required":true,"description":"Series ID (CDID), lowercase"},{"name":"dataset","type":"string","required":true,"description":"Source dataset ID, lowercase"}],"exampleUrl":"https://clify-dev.netlify.app/ons/list-timeseries-versions"},{"command":"get-bulletin","summary":"Get a statistical bulletin edition: title, summary, release and next-release dates, and its sections","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"},{"name":"series","type":"string","required":true,"description":"Bulletin series slug, e.g. consumerpriceinflation"},{"name":"edition","type":"string","required":true,"description":"Edition slug, e.g. august2026 (take it from list-bulletin-releases)"}],"exampleUrl":"https://clify-dev.netlify.app/ons/get-bulletin"},{"command":"list-bulletin-releases","summary":"List all past editions of a bulletin series, newest first","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"},{"name":"series","type":"string","required":true,"description":"Bulletin series slug"},{"name":"page","type":"number","description":"Page number (10 per page)","default":1}],"exampleUrl":"https://clify-dev.netlify.app/ons/list-bulletin-releases"},{"command":"list-bulletin-related-data","summary":"List the datasets and data related to a bulletin edition","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"},{"name":"series","type":"string","required":true,"description":"Bulletin series slug"},{"name":"edition","type":"string","required":true,"description":"Edition slug, e.g. august2026"}],"exampleUrl":"https://clify-dev.netlify.app/ons/list-bulletin-related-data"},{"command":"get-dataset","summary":"Get a dataset page: title, description, release info, any correction notice and the current edition's file download link","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"},{"name":"dataset","type":"string","required":true,"description":"Dataset slug, e.g. consumerpriceinflation, consumerpriceindices"}],"exampleUrl":"https://clify-dev.netlify.app/ons/get-dataset"},{"command":"list-topic-data","summary":"List all published data (time series, datasets, user-requested data) for a topic, with keyword filter, sorting and paging","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"},{"name":"filter","type":"string","description":"Data type filter","oneOf":["time_series","datasets","user_requested_data"]},{"name":"q","type":"string","description":"Keyword filter"},{"name":"sort","type":"string","description":"Sort order","oneOf":["relevance","release_date","title"]},{"name":"page","type":"number","description":"Page number (10 per page)","default":1}],"exampleUrl":"https://clify-dev.netlify.app/ons/list-topic-data?filter=datasets&sort=release_date"},{"command":"list-topic-publications","summary":"List all publications (bulletins, articles and so on) for a topic, with keyword filter, sorting and paging","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"},{"name":"q","type":"string","description":"Keyword filter"},{"name":"sort","type":"string","description":"Sort order","oneOf":["relevance","release_date","title"]},{"name":"page","type":"number","description":"Page number (10 per page)","default":1}],"exampleUrl":"https://clify-dev.netlify.app/ons/list-topic-publications"},{"command":"list-topic-headline-series","summary":"List a topic page's headline (spotlight) time series uris, e.g. CPIH/CPI/RPI for inflation","params":[{"name":"topic","type":"string","required":true,"description":"Topic path without leading/trailing slash"}],"exampleUrl":"https://clify-dev.netlify.app/ons/list-topic-headline-series"},{"command":"list-releases","summary":"List the release calendar (published, upcoming or cancelled releases) with keyword search, sorting and paging, read from the RSS feed","params":[{"name":"keywords","type":"string","description":"Keyword search, e.g. gdp"},{"name":"release_type","type":"string","description":"Release status","oneOf":["type-published","type-upcoming","type-cancelled"],"default":"type-published"},{"name":"sort","type":"string","description":"Sort order","oneOf":["date-newest","date-oldest","alphabetical-az","alphabetical-za","relevance"],"default":"date-newest"},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/ons/list-releases?keywords=gdp&release_type=type-upcoming&sort=date-oldest"},{"command":"get-release","summary":"Get a release calendar entry: title, release date and time, publication status and summary","params":[{"name":"slug","type":"string","required":true,"description":"Release slug, i.e. the last path segment of a release calendar link"}],"exampleUrl":"https://clify-dev.netlify.app/ons/get-release"}]}