% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/catalog.R
\name{ds_search}
\alias{ds_search}
\title{Search for series across all datasets}
\usage{
ds_search(pattern = NULL)
}
\arguments{
\item{pattern}{optional search string, treated as a case-insensitive regular
expression and matched against the series \code{label} and \code{dataset_title}. When
\code{NULL} (the default) the full table is returned.}
}
\value{
A \code{data.frame} with the columns \code{dataset}, \code{dataset_title},
\code{frequency}, \code{dim}, \code{code}, \code{label} and \code{path}.
}
\description{
Returns a flat, searchable table of the individual series available across
every dataset on \href{https://dataseries.org}{dataseries.org} — one row per
series. This is the finest-grained way to discover what exists: grep it, or
pass a \code{pattern} to filter. The \code{dataset}, \code{dim} and \code{code} columns are
exactly what you feed back to \code{\link[=ds]{ds()}}.
}
\examples{
\dontrun{
# everything
ds_search()

# find unemployment series, then download one
hits <- ds_search("unemployment")
head(hits)
ds(hits$dataset[1], setNames(list(hits$code[1]), hits$dim[1]))
}
}
\seealso{
\code{\link[=ds_catalog]{ds_catalog()}} for the dataset-level list and \code{\link[=ds_meta]{ds_meta()}} for one
dataset's dimensions.
}
