1
credit
Create or list segments
2
credits
At-home count per geography
US
coverage
Block group resolution
0
credits
Catalog lookup
Audiences are defined as Boolean expressions over segments. Popcast supplies population counts at the block-group level. Basecast supplies the behavioral and consumer segment overlays. The Audiences application fuses the two, applies your operator logic, and returns a sized audience object.
Every sizing call includes a provenance block plus a composition block with the segment-level breakdown that produced the audience.
What you get
- A reusable cohort definition keyed to your org's Popcast segment library.
- At-home population counts per geography for that cohort.
- Access to the canonical Motionworks audience segment catalog.
When to use this Job
- You are sizing a market for a new product launch.
- You need to compare cohort density across DMAs or block groups.
- You are sourcing audience inputs for a Set Dynamics scenario.
How it works
- 1 Define a cohort with
POST /popcast/segments(demographic filters + name). - 2 Reuse the canonical Motionworks segments via
GET /segmentsif your cohort is already covered. - 3 Count matching people in each geography with
GET /popcast/at-home.
Primary endpoints
| Method | URL | Credits | Status | Summary |
|---|---|---|---|---|
| POST | https://api2.mworks.com/v2/popcast/segments | 1 | production | Define a population segment |
| GET | https://api2.mworks.com/v2/popcast/at-home | 2 | production | Count a segment's residents by geography |
| GET | https://api2.mworks.com/v2/popcast/segments/{segment_id} | 1 | production | Read one segment |
GET /popcast/at-home getPopcastAtHome
| Name | In | Type | Required | Description |
|---|---|---|---|---|
segment_id | query | string | Required | The `motionworks_segment_id` of the segment to count. |
geography_id | query | string | Optional | A single geography to count, for example `US2010XXBG360610031001` (block group) or `US2020STCO36061` (county). Omit it and pass `geography_type` to iterate across every geography of that type. |
year | query | integer | Optional | Population vintage year. Omit for the current vintage. |
geography_type | query | string | Optional | Geography level to iterate when `geography_id` is omitted: `bg` (Census block group), `zcta` (ZIP Code Tabulation Area), `stco` (county), `cbsa` (metropolitan or micropolitan statistical area), `dma` (Nielsen DMA) or `state`. |
cursor | query | string | Optional | The `cursor` from the previous response's pagination block. Omit for the first page. |
limit | query | integer | Optional | Rows per page. |
GET /popcast/segments/{segment_id} getPopcastSegment
| Name | In | Type | Required | Description |
|---|---|---|---|---|
segment_id | path | string | Required | The `motionworks_segment_id` returned when the segment was created. |
Supporting endpoints
| Method | URL | Credits | Summary |
|---|---|---|---|
| GET | https://api2.mworks.com/v2/popcast/segments | 1 | List your organization's segments |
| GET | https://api2.mworks.com/v2/segments | 1 | List audience segments |
| GET | https://api2.mworks.com/v2/segments/{id} | 1 | Read one segment |
| GET | https://api2.mworks.com/v2/markets | 1 | List DMA markets |