Count stories matching a query

Usage

mc_story_count(
  query,
  start_date,
  end_date,
  collection_id = NULL,
  source_id = NULL,
  platform = mc_platforms,
  .token = NULL
)

Arguments

query: the search string, in Elasticsearch/Lucene syntax. "*" matches everything.
start_date, end_date: the period to search, as Date objects or "YYYY-MM-DD" strings. Both are required.
collection_id, source_id: ids to search within, as returned by mc_collections() and mc_sources(). At least one of the two is required. Vectors are allowed.
platform: which archive to query. "onlinenews-mediacloud" is the Media Cloud index; "onlinenews-waybackmachine" searches the Wayback Machine instead.
.token: a token, or path to a saved token file, to use instead of the stored one.

Value

A tibble with one row and two columns: relevant, the number of stories matching query, and total, the number of stories held for the same sources and period. The ratio of the two is the "attention" measure Media Cloud reports.

Examples

if (FALSE) { # \dontrun{
mc_story_count("klima", "2026-08-01", "2026-08-07", collection_id = 34412409)
} # }