Today, we introduce Version 7 of the Twitter Ads API, designed to increase feature parity with ads.twitter.com.
As with previous versions, there will be a 6 month transition period to migrate to v7. On 2020-09-01, version 6 of the Ads API will no longer be available. We encourage all developers to migrate to the latest version of the API as soon as possible to avoid any service disruptions. Version 5 of the Ads API has reached its end of life and is no longer available.
New
Audience Summary
Engineering effort: Minimal
The Audience Summary endpoint returns information about the total number of active Twitter users that fit an advertiser’s Targeting Criteria. It uses the same data source that powers the audience summary estimate on ads.twitter.com.
The Audience Summary endpoint is a replacement for the existing Reach Estimate endpoint and is designed to be interoperable with the batch Targeting Criteria create endpoint.
Granular Twitter Audience Platform (TAP) Placements
Engineering effort: Minimal
In v7, Ads API developers and their advertisers can now select specific TAP placements. The POST accounts/:account_id/line_items and the PUT accounts/:account_id/line_items/:line_item_id endpoints now support the following values for the placements request parameter:
TAP_FULLTAP_FULL_LANDSCAPETAP_BANNERTAP_NATIVETAP_MRECT
The GET line_items/placements endpoint will return these values in v7 as well.
Advertiser Business Categories
Engineering effort: Minimal
The GET advertiser_business_categories endpoint returns categories that advertisers can use to describe their businesses to publishers. Some examples include Consumer Packaged Goods, Financial Services, and Travel. On ads.twitter.com, these categories are referred to as “Brand Categories.” Each of these Advertiser Business Categories map to a specific set of IAB categories, which are abstracted away from the advertiser on ads.twitter.com. These categories should be set when creating In-stream Video Ads (VIDEO_VIEWS_PREROLL) campaigns.
To set these categories, developers should fetch categories from the GET advertiser_business_categories endpoint, and pass in the corresponding iab_categories associated with the Advertiser Business Category into the categories parameter on the POST or PUT accounts/:account_id/line_items/:line_item_id endpoint.
Changed
Entity Status in Media Creatives
Engineering effort: Minimal
The serving_status response attribute that appears in Media Creatives objects is being renamed to entity_status to be consistent with other Ads API endpoints.
| v6 |
v7 |
serving_status |
entity_status |
Removed
Reach Estimate
Engineering effort: Minimal
The GET accounts/:account_id/reach_estimate endpoint is no longer available in v7. It has been replaced with the Audience Summary endpoint.
Twitter Ads API team
