Will Airings data change over time?
- In short, yes. Most updates are made within the first few days. Use updates endpoints to determine additions/corrections
-
Status shows deleted or updated with old and new values.
Any best practices on date range to ensure most up to date data?
-
It is good practice to use a rolling 30 day window to ensure the most up-to-date data. Impressions can still be tied to an airing up to 30 days of its airing date but impression numbers usually won't change much after 3 days.
What is the earliest you can pull Airings from the API?
Timing: (Exact times cannot be provided as these may vary)
- Our Airing data is updated 3 times a day. Here are the approximate times they are updated in PST. Noon, 5PM , and midnight.
How far back is data available?
- TV Airings are available as far back as 2012
- Impressions are available from 2016
- Attention metrics are available from 2018
Is there a limit to how many API calls can be made?
- Yes, these are known as rate limits which vary by endpoint. Please see below for a full list of rate limits. Rate limits are subject to change without notice
Last updated since 7/24/2023
The limit is the number of API calls that can be made within a certain period (seconds)
For metrics/tv/airings, 50 API calls can be made within 60 seconds
v4/access, limit: 100, period: 900
v4/account, limit: 100, period: 900
v4/airings, limit: 50, period: 60
v4/brands, limit: 50, period: 60
v4/celebrities, limit: 50, period: 60
v4/events, limit: 50, period: 60
v4/industries, limit: 50, period: 300
v4/metrics/tv/airings, limit: 50, period: 60
v4/metrics, limit: 10, period: 10
v4/metrics/impressions/ott, limit: 50, period: 60
v4/metrics/tv, limit: 25, period: 10
v4/movies, limit: 50, period: 60
v4/networks, limit: 50, period: 60
v4/notifications, limit: 100, period: 60
v4/product-categories, limit: 50, period: 60
v4/products, limit: 50, period: 60
v4/shows, limit: 50, period: 60
v4/spots, limit: 50, period: 60
v4/users, limit: 50, period: 60
v4/planning, limit: 50, period: 60