Skip to contents

Search for ONS time series

Source: R/ons_search.R
ons_search.Rd

Searches the ONS catalogue for time series matching a keyword or phrase. Returns CDID codes, titles, and dataset information that can be used with ons_get().

Usage

ons_search(query, limit = 10L)

Source

https://www.ons.gov.uk

Arguments

query

Character. Search term (e.g. "GDP growth", "unemployment").

limit

Integer. Maximum number of results to return (default 10, maximum 50).

Value

A data frame with columns:

cdid

Character. The four-character CDID code.

dataset_id

Character. The ONS dataset identifier.

title

Character. Description of the series.

release_date

Character. Date of the most recent release.

See also

Other data access: clear_cache(), ons_get()

Examples

# \donttest{
op <- options(ons.cache_dir = tempdir())
try(ons_search("GDP growth"))
#>    cdid dataset_id                                         title
#> 1  KB82        PN2                 Revisions to GDP CVM growth %
#> 2  KB82        QNA                 Revisions to GDP CVM growth %
#> 3  IHYS       UKEA       GDP Deflator: Year on Year growth: SA %
#> 4  IHYT        QNA GDP Deflator: Quarter on quarter growth: SA %
#> 5  IHYS        QNA       GDP Deflator: Year on Year growth: SA %
#> 6  MNF4        PN2 GDP Deflator: Quarter on quarter growth: SA %
#> 7  MNF3        QNA       GDP Deflator: Year on Year growth: SA %
#> 8  MNF4        QNA GDP Deflator: Quarter on quarter growth: SA %
#> 9  IHYT        PN2 GDP Deflator: Quarter on quarter growth: SA %
#> 10 IHYT       UKEA GDP Deflator: Quarter on quarter growth: SA %
#>                release_date
#> 1  2026-02-12T00:00:00.000Z
#> 2  2026-03-30T23:00:00.000Z
#> 3  2026-03-30T23:00:00.000Z
#> 4  2026-03-30T23:00:00.000Z
#> 5  2026-03-30T23:00:00.000Z
#> 6  2026-02-12T00:00:00.000Z
#> 7  2026-03-30T23:00:00.000Z
#> 8  2026-03-30T23:00:00.000Z
#> 9  2026-02-12T00:00:00.000Z
#> 10 2026-03-30T23:00:00.000Z
options(op)
# }