DMA Use Cases

API updates and articles

DMA endpoint returns impression by DMA for National Airings. These impressions are extrapolated using US census data. 

 

https://api.ispot.tv/v4/metrics/audience/dma?sort=-audience_impressions_national_linear&filter[airing_type]=N,R&filter[national_only]=1&filter[brand]=brandid is the most basic call. Below is a screenshot of the result. Results are broken out by DMA. 

dma

DMA endpoint also supports some group bys. 

For example, to group by creative, https://api.ispot.tv/v4/metrics/audience/dma?filter[group_by]=C&sort=-audience_impressions_national_linear&filter[airing_type]=N,R&filter[national_only]=1&filter[brand]=brandid

Full list of Group bys below. DMA endpoint alo supports multiple group bys. 

GROUP_BY_INDUSTRY = 'I';

GROUP_BY_PARENT_BRAND = 'P';

GROUP_BY_BRAND = 'B';

GROUP_BY_SPOT = 'A';

GROUP_BY_CREATIVE = 'C';

GROUP_BY_DAY_OF_WEEK = 'W';

GROUP_BY_DATE = 'T';

GROUP_BY_MONTH = 'M';

GROUP_BY_WEEK = 'K';

GROUP_BY_DMA_ID = 'Q';

 

While the DMA endpoint will only return the DMA impressions for National Airings, the API also contains a local endpoint for local airings for some DMAs. Local endpoint does not return national airings nor impressions (for now)

https://api.ispot.tv/v4/metrics/tv/airings/local

 

Below are the DMAs where local airings will report on. 

Atlanta

Boston (Manchester)

Charlotte

Chicago

Cleveland-Akron (Canton)

Dallas-Ft. Worth

Denver

Detroit

Houston

Indianapolis

Los Angeles

Miami-Ft. Lauderdale

Minneapolis-St. Paul

Nashville

New York

Orlando-Daytona Bch-Melbrn

Philadelphia

Phoenix (Prescott)

Pittsburgh

Portland Or

Sacramnto-Stkton-Modesto

Salt Lake City

San Francisco-Oak-San Jose

Seattle-Tacoma

St. Louis

Tampa-St. Pete (Sarasota)

Washington DC (Hagrstwn