The compose-and-publish flow
Five calls. One citable map.
Every threshold in the filter is printed verbatim in the caption. freeze=true snapshots the underlying datasets at publish time, so the embed stays valid even when the Census or election data is later revised.
// 1 — Find 2024 swing states (≤ 5pt margin)
classify_states({ cycle: 2024, margin_pct: 5 })
→ ["AZ","GA","MI","NV","NH","NC","PA","WI"]
// 2 — Resolve "low income" to a stable threshold using Census data
demographic_bands({
dataset_slug: "acs-county-mhi-2023", // median household income (Census)
field: "B19013_001E", // Census variable ID
method: "quintile",
})
→ bottom-quintile cutoff: $52,140
→ top-quintile cutoff: $98,720
// 3 — Compose the filter, get a sample + caption
query_counties({
filter: {
state_in: [...swing],
winner_party: "REP",
margin_pct_abs_lte: 10,
demographic_band: {
dataset_slug: "acs-county-mhi-2023",
field: "B19013_001E", band: "Q1",
},
},
order_by: "margin asc", limit: 500,
})
// 4 — Wrap it in a view config
create_map_view({ result_set_id, style: "choropleth_margin" })
// 5 — Mint /v/<slug> + iframe + .png + citation.json
publish_map({ view_id, freeze: true })
