Ad
ads.adUnifiedSoonOne ad with its creative, review result, spend and results. Ads from a public ad library come back too.
key platform + ad ID12 planned calls2 Direct endpoints today
12 calls plannedSoon
Our own first draft of the paths, not reviewed yet. Each call acts on the platforms it lists through the Connection you grant, and none is deployed yet.
- GET
/Ads with status, review result and spendAll 8 ad platformsDraftv1/ ads - GET
/One ad with its creativeAll 8 ad platformsDraftv1/ ads/ {adId} - GET
/Results of one ad by dayAll 8 ad platformsDraftv1/ ads/ {adId}/ analytics - GET
/The platform's review result, with every rejection reasonMeta · Google · TikTokDraftv1/ ads/ {adId}/ review - POST
/Render how an ad looks in each placementMetaDraftv1/ ads/ preview - POST
/Create an ad, with a new campaign and ad set when neededAll 8 ad platformsDraftv1/ ads/ create - POST
/Turn an existing post into an adMeta · TikTok · LinkedIn · Pinterest · X · RedditDraftv1/ ads/ boost - PUT
/Change an ad's creative or targetingMeta · Google · TikTok · LinkedIn · RedditDraftv1/ ads/ {adId} - PUT
/Pause or resume an adAll 8 ad platformsDraftv1/ ads/ {adId}/ status - DELETE
/Delete or cancel an adAll 8 ad platformsDraftv1/ ads/ {adId} - GET
/Comments on an ad, including ads that never ran as a postMeta · TikTokDraftv1/ ads/ {adId}/ comments - GET
/Search the public ad library for any advertiser's adsMeta · LinkedInDraftv1/ ads/ library
FieldsDraft · fields may change
A first cut of the schema from the ad platforms' own objects. Names, types and coverage can change before the Unified layer ships.
Observable
A fresh snapshot if there is one, otherwise a live read, otherwise the next sourcead_setAdSetReportedcreativeCreativeReportedpostPostReportedSet when the ad boosts an existing PoststatusStatusReportedreview_statusStatusReportedThe platform's ad review result and its reasonspendMoneyReportedimpressionsintegerReportedclicksintegerReportedctrnumberReportedcpmMoneyReportedconversionsnumberReportedlibraryLibraryEntryObservedFrom the public ad library, for ads you do not run
Call it today through DirectLive
Vendor endpoints that already return this kind of object, in the vendor's own format. Your code names the vendor, so switching vendors means changing it.
2 endpoints from 1 API · from $0.88
Next to Ad
Each link is a field you can ask for in the same call.
AdSet
platform + ad set IDThe targeting, budget and placements a group of ads shares. Google calls it an ad group.
Creative
platform + creative IDThe media, text and call to action an ad shows, reusable across ads.
Post
platform + post IDA post on one platform, with its link and metrics.
Comment
platform + comment IDA comment, reply or page review. Read, reply, hide or delete.