2021 Measures

Geopath is in the process of updating its annual measures for 2021.

This does not change the measures for 2020 but will be a new dataset that represents the forecast for 2021. 

Additionally, Geopath will release an updated midyear forecast for 2021. 

Currently when requesting measures, the response returns measures from the January 2021 forecast. The full list of the audiences available for 2021 measures can be found in this Excel file.

Given the accelerated rate of recovery from the COVID-19 Pandemic, Geopath will issue an updated annual forecast in June 2021. This midyear annual forecast will be a 12-month forecast and will reflect the expected audience delivery from June 2021 through May 2022. More information on this here.

While the 2020 and January 2021 data will remain available in the API, it should only be used for historical purposes moving forward. As always, Geopath members should clearly disclose which data vintage is being used when sharing Geopath audience data with other members or clients.

If  a use case requires previous measures, a new parameter has been added to all endpoints that return measures. It's detailed in the specific documentation for each endpoint, but on POST endpoints can be referenced as "measures_release" in the request body, and in GET endpoints, can be referenced using "measures_release" as a URL parameter. In either case, the supported values are 2020 or 2021 and "2021r1". If a value other than that is provided, 2025 for example, the API will respond with a 400 error.

The parameter to request 2021 Midyear impressions is "2021r1". This is currently scheduled to become the default release on June 21, 2021

To be clear, the use of this additional parameter is optional. If the parameter is not provided, the response will continue to return the most current released measures. Bulk files will continue to represent the default behavior unless otherwise noted. 

Please contact apisupport@geopath.org if you have any questions.