Define a cohort and count where they live

Build a custom audience segment from demographic filters, then count how many matching people live in each geography. Use the canonical Motionworks segment catalog when an off-the-shelf cohort is good enough.

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.

POPCASTDATAPopulation countsblock-group · demographic overlaysBASECASTDATAConsumer segmentsPRIZM · intender · behavioralAUDIENCESAPPLICATIONDefine · Combine · Sizenamed, persistent audience IDs

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. 1 Define a cohort with POST /popcast/segments (demographic filters + name).
  2. 2 Reuse the canonical Motionworks segments via GET /segments if your cohort is already covered.
  3. 3 Count matching people in each geography with GET /popcast/at-home.

Primary endpoints

Method URL Credits Status Summary
POST https://api.mworks.com/v2/popcast/segments 1 production Define a custom population segment
GET https://api.mworks.com/v2/popcast/at-home 2 production Count matching persons per geography for a segment
GET https://api.mworks.com/v2/popcast/segments/{segment_id} 1 production Get a segment by motionworks_segment_id

GET /popcast/at-home getPopcastAtHome

Name In Type Required Description
segment_id query string Required
geography_id query string Optional
year query integer Optional
geography_type query string Optional
cursor query string Optional
limit query integer Optional

GET /popcast/segments/{segment_id} getPopcastSegment

Name In Type Required Description
segment_id path string Required

Supporting endpoints

MethodURLCreditsSummary
GET https://api.mworks.com/v2/popcast/segments 1 List segments defined for this org
GET https://api.mworks.com/v2/segments 1 List audience segments
GET https://api.mworks.com/v2/segments/{id} 1 Get segment detail
GET https://api.mworks.com/v2/markets 1 List all DMA markets

Underlying data

Recent changes

  • — Jobs-organized IA pilot. Endpoint tables now generated from OpenAPI specs (api-mworks-com@d211f84).