Term Series

get /storywrangler/term-series

Per-date time series for a single type in any registered types-counts dataset.

Returns counts, and rank/freq when the dataset declares rank_column/ freq_column. Fast path: hash-bucket lookup on the type-first sparkline companion (resolved from lineage); slow fallback: a scan of the date-first tree for types outside the precomputed vocabulary. mongodb datasets are served through the same endpoint (find + range, no aggregation).

include=<role> (or include=all) attaches a type-documents companion's ranked source documents per date (the provenance behind each entry).

Query Parameters

domain string

Domain owning the dataset

dataset string

Dataset ID within the domain

type string required

The type/term to look up. Case-sensitive.

entity

Global entity ID (e.g. 'wikidata:Q30') or local ID. Omit for datasets without entity_mapping.

dates

Date range: a single date '2024-06-01' or 'start,end' like '2024-01-01,2024-12-31'. Omit for full history.

weight

Count measure — one of the dataset's endpoint_schema.count_column entries. Defaults to the first.

sparkline_dataset

Deprecated. The type-first sparkline companion is resolved from lineage; pass a dataset_id only to override, or '' to disable the fast path (dist-tree scan only).

include

Comma-separated provenance role(s) to attach per date (e.g. 'articles'), or 'all' for every declared companion. Roles are resolved from the primary's lineage; a raw type-documents dataset id also works (deprecated).

include_dates

Comma-separated exact dates to attach provenance for (e.g. the two comparison dates '2026-01-20,2026-01-21'). Narrows the ?include= documents only; the series itself keeps its dates range. Omit to attach documents for every date in range.

Available Datasets

Pass these as additional query parameters using the actual column names from each dataset.

babynames/ngrams

Baby names by popularity, year, and location with entity mappings

No filter dimensions.

bluesky/ngrams

Date-first ngram distributions for Bluesky — all count measures per (ngram, date), by language and ngram size, bundled one ISO week per file under year/month for single-date distribution and rank-divergence queries. Includes repost/quote attention-weighted measures (count_all). Companion to the hash-bucketed bluesky/sparklines per-term time series.

n default: 1 · 1, 2

lang default: en · af, als, am, an, ar …and 171 more

reddit/ngrams

Reddit ngrams

n default: 1 · 1, 2

lang default: af · af, als, am, an, ar …and 162 more

twitter/ngrams

Storywrangler Twitter n-grams (1/2/3-grams across 169 languages), served from MongoDB. One document per (word, day) with with-RT and no-RT counts, ranks, and frequencies.

No filter dimensions.

vt-zoning-atlas/ngrams

Vermont zoning bylaw word frequencies by town.

No filter dimensions.

wikimedia/ngrams

Wikipedia n-grams by frequency, date, and location with entity mappings and ranks

ngram_size default: 1 · 1, 2

granularity default: daily · daily, monthly, weekly

Response

type string

The type/term looked up (echoed back).

latest_available_date string

Most recent date with data for the resolved slice.

series array

One entry per date, chronological. rank/freq appear only when the dataset declares rank_column/freq_column. With ?include=, each entry also carries a key named for the requested provenance role (e.g. articles) holding a ranked [[document, score], ...] list.

curl -X GET https://api.storywrangler.uvm.edu/storywrangler/term-series \