Storywrangler
Navigation

Term Series Batch

get /storywrangler/term-series/batch

Batch term-series — a map of type → series in one request.

Query Parameters

domain string

Domain owning the dataset

dataset string

Dataset ID within the domain

types string required

Comma-separated types, e.g. 'trump,covid,the'. Case-sensitive.

entity

Global entity ID or local ID. Omit for datasets without entity_mapping.

dates

Date range: a single date or 'start,end'. Omit for full history.

weight

Count measure — defaults to the first registered.

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.

include

Comma-separated provenance role(s) to attach per date, or 'all'. 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
curl -X GET https://api.storywrangler.uvm.edu/storywrangler/term-series/batch \