Ad API Guide

Notes

What changed, and when

One entry whenever a published number moves: a provider changed a price, a weekly run shifted a result, a correction landed, a cohort got a new version. Nothing here is commentary.

2026-11-09Run/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Weekly re-run 2026-11-09: 97 of 100, proxy errors recur without the overlap, first Apify Meta timeout

Ninth run of cohort v1: 100 calls, 97 returned, $1.38 at list prices. ScrapeCreators’ Meta keyword route failed on Shopify and Semrush with the same upstream proxy error as last week (HTTP 500, “Proxy rejected the CONNECT tunnel with status code 429”, no credits charged). This run did not overlap the SEO cohort, so last week’s guess that the overlap caused the error no longer holds. Apify’s Meta run for Semrush ended TIMED-OUT at the 90-second limit treg has applied since 26 October, the first Apify Meta timeout since the cohort began. None of the three was retried. Latency columns still overstate provider time. SerpApi reported a median 0.99 s of its own processing time; our runner’s clock read 17.0 s (16.5 s last week, 2.1 s on 19 October). The machine was busy with unrelated work, but the SEO cohort had finished first, so the gap is not explained by the overlap. We still cannot tell how much of it is our machine and how much the treg gateway. On Meta by page name, ClickUp returned 391 active ads after last week’s error; monday.com went from 302 to 137, Canva 2,341 to 1,641 and Shopify 3,721 to 5,710. By keyword, HubSpot rose from 3,399 to 4,474 and Apollo.io from 70 to 103. Google’s rounded estimates were unchanged except Grammarly (50,000 to 40,000). On TikTok through ScrapeCreators, HubSpot’s total fell from 60 to 11, lululemon’s from 5,000 to 3,650 and Semrush’s from 2 to 1, and ClickUp went from 0 to 1. Apify’s TikTok actor returned 68 ads in total, down from 103: Notion, Canva and lululemon came back with 10 or 11 rather than 20, and there was no error to explain it. On LinkedIn, ClickUp’s library count fell from 679 to 539, and the share of first-page ads with dates and impression ranges went from 18% to 12%. No field’s presence share moved by 10 points. First-page churn against 2 November was 98% of Google creative ids, 51% on LinkedIn, 37% on Meta by page name, 31% by keyword and 20% through Apify.

2026-11-08Run/guides/google-paid-results-from-serp-apis

Paid SERP check 2026-11-08: 200 fetches, 28 with a text ad

25 US commercial keywords, two fetches each a few minutes apart, through four SERP routes on 8 November 2026 (New York, desktop where the route takes a location). 199 of 200 fetches answered (one Litescrape service_unavailable, not billed). Fetches with a text ad: SerpApi 12, DataForSEO 10, Cloro 4, Litescrape 2. 38 keyword-advertiser pairs on 14 keywords; SerpApi saw 20, DataForSEO 18, Cloro 5, Litescrape 4; 30 seen by one route only. 11 keywords had no text ad on any fetch. Same-route advertiser overlap between fetches: 0.21 SerpApi, 0.15 DataForSEO. Sponsored Shopping (shopping_results) only from Litescrape’s ads route, 5 of 7 product keywords on both fetches. Settled per fetch: SerpApi $0.015, DataForSEO $0.002, Cloro $0.002, Litescrape $0.00015; about $0.96 for the run, about $1.02 including probes.

2026-11-02Run/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Weekly re-run 2026-11-02: 98 of 100, ClickUp lost on two Meta routes, monday.com back, latency readings inflated

Eighth run of cohort v1: 100 calls, 98 returned, $1.58 at list prices. Both failures were ClickUp on ScrapeCreators’ Meta routes, page name and keyword, seconds apart: HTTP 500 with “Proxy rejected the CONNECT tunnel with status code 429”, no credits charged. They were not retried, so ClickUp has no Meta count from ScrapeCreators this week; Apify returned 20 ClickUp ads in the same run. This week’s latency columns overstate provider time and should not be read as a slowdown. This run shared its machine with the SEO cohort and other scheduled jobs. SerpApi, the only route that reports its own processing time, took a median 0.93 s (1.08 s last week) while our runner’s clock read 16.5 s (5.1 s last week, 2.1 s on 19 October). Every route’s median reading rose in the same run, by 1.2 to 3.6 times; we cannot separate time on our machine from time in the treg gateway, and last week’s “medians roughly doubled” may be the same effect. All p50 and p95 figures below are as measured by the runner. Apify’s Meta median read 49.2 s and its slowest call 92.0 s, with no call timing out. On Meta, ScrapeCreators’ page-name route found monday.com again (302 active ads and a full first page, after 0 on 26 October and 519 on 19 October). Grammarly fell by page name from 276 to 198 and by keyword from 208 to 146; Semrush’s keyword count rose from 114 to 161. No other Meta count moved by a quarter. Google’s rounded estimate for Notion went from 11 to 9 and Shopify’s from 70,000 to 80,000; the other eight domains were unchanged. On TikTok through ScrapeCreators, ClickUp went from 3 to 0, Apollo.io from 1 to 0, monday.com from 0 to 1, Grammarly 4 to 6 and Semrush 1 to 2. On LinkedIn the share of first-page ads with dates and impression ranges fell from 28% to 18% while library counts moved 4% or less. First-page churn against 26 October was 98% of Google creative ids, 26% on Meta by keyword and through Apify, 22% by page name leaving out monday.com, and 50% on LinkedIn.

2026-10-26Run/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Weekly re-run 2026-10-26: 100 of 100 after an Apify re-issue, monday.com's Meta page-name route returns zero

Seventh run of cohort v1: 100 calls, 100 returned, $1.56 at list prices, no field’s presence share moved by 10 points or more. The first attempt at 00:01 UTC had both Apify routes rejected 10 of 10 before any call reached Apify: treg’s Apify endpoints now require a maxTotalChargeUsd spend cap of at most $1, a timeout of 90 s or less and enrichWithEcommerceData set to false, and the runner sent none of them. The runner was fixed and the 20 Apify calls re-issued between 00:06 and 00:12 UTC; all 20 returned and those are the results in this run’s tables. The other eight routes were not re-run. The 20 rejected receipts are kept with the loop and not published. On Meta, ScrapeCreators’ page-name route returned no ads and an active count of 0 for monday.com (519 and a full first page last week), while the keyword route returned 30 monday.com ads and Apify 20 the same minute, so the gap is in the page-name lookup rather than in Meta’s library. Notion’s keyword-search count went from 3,420 to 2,543. No other Meta count moved by a quarter (HubSpot 248 to 279, Shopify 4,561 to 4,001 by page name). Google’s rounded estimate for Notion went from 16 ads to 11 and Shopify’s from 80,000 to 70,000; the other eight domains were unchanged. On TikTok through ScrapeCreators, ClickUp went from 6 to 3, Semrush 2 to 1, Grammarly 3 to 4 and monday.com stayed at 0. First-page churn against 19 October was 97% of Google creative ids, 10% to 21% on Meta and 58% on LinkedIn. Under the new 90 s ceiling Apify’s Meta median was 40.1 s and its p95 51.0 s, down from 107 s; its TikTok median was 23.0 s. ScrapeCreators’ medians roughly doubled across routes (Meta page name 3.3 s to 7.0 s, Google advertiser lookup 1.3 s to 5.1 s).

2026-10-19Run/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Weekly re-run 2026-10-19: 100 of 100 again, Notion's Meta library up 77%

Sixth run of cohort v1: 100 calls, 100 returned, $1.58 at list prices. It’s the second clean week in a row: every route returned all ten, and no field’s presence share moved by 10 points or more. Notion’s active Meta library through ScrapeCreators’ page-name route went from 112 to 198 ads. No other Meta count moved by more than a quarter (Shopify 4,208 to 4,561, Canva 2,421 to 2,481). On TikTok through ScrapeCreators, monday.com returned no ads and a total of 0, down from the single ad it had shown since 21 September. Apollo.io’s total went from 2 to 1 and Notion’s from 1,113 to 1,325. Through Apify, Shopify returned 20 TikTok ads (5 last week). Google’s rounded estimates didn’t change for nine of ten domains, and Notion went from 17 ads to 16. First-page churn against 12 October was 95% of Google creative ids, 19% to 24% on Meta and 57% on LinkedIn. Apify’s Meta median eased to 36.8 s and its p95 to 107 s; its TikTok median was 19.6 s.

2026-10-19Run/guides/see-competitor-chatgpt-ads

ChatGPT ads check 2026-10-19: 42 answers, no ads

Twelve commercial prompts through three ChatGPT answer routes on 19 October 2026. Cloro (ads and shopping flags on) returned 12 of 12 in desktop mode and 12 of 12 in default mode in the US, plus 6 of 6 for three prompts from the UK and Canada; DataForSEO’s ChatGPT LLM Scraper returned 12 of 12 in the US; crawl4ai’s logged-out ChatGPT answer failed on all 12 (fetch_failed, not billed). 42 answers, 0 ads; Cloro’s ads array was empty on all 30 calls and no answer text contained “sponsored”. DataForSEO returned a product block on 3 prompts (mattresses, running shoes, travel cards), which are ChatGPT’s shopping results, not ads. Median time 27 to 35 s a call. Cost $0.0036 a Cloro call, $0.004 a DataForSEO call; the balance fell $0.16 across the run, including one probe.

2026-10-12Run/guides/check-if-prospects-run-ads

Run 2026-10-12: 18 of 40 local-business prospects were running ads; look them up by domain and read the last-shown date

40 local-business domains (five each from eight Google local-service queries in eight US cities) went through three Google Ads Transparency Center routes (ScrapeCreators, Adyntel, SerpApi, all by domain) and two Meta Ad Library routes (Adyntel by domain, ScrapeCreators by page name, US, active) on 11 October 2026 UTC: 200 calls. 17 prospects had a Google ad shown in the last 30 days, 10 an active US Meta ad, 18 either; 3 more had only older Google ads (April, August, January). The three Google routes returned identical creative ids, first pages and library estimates on all 40. For 8 of the 20 with Google ads no payer name matched the business (parent company, agency or person). On Meta the domain and name routes found 9 each and disagreed on 2: a page name that differs from the brand, and a second page. Adyntel returned 204 (not billed) for 5 domains with no Facebook page. HVAC 5 of 5 and plumbers and injury lawyers 4 of 5 were advertising; dentists and med spas 0 of 5. Cost about $1.47 at list prices (ScrapeCreators on the account’s own key, $0 on Treg). Prompted by an X thread on using the Transparency Center as a lead-gen qualifier (scout row of 2026-10-10).

2026-10-12Run/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Weekly re-run 2026-10-12: all 100 calls returned, LinkedIn back to ten of ten

Fifth run of cohort v1: 100 calls, 100 returned, $1.53 at list prices. Every route returned all ten. That includes the three ScrapeCreators routes that failed together on 5 October (Meta page-name, Meta keyword and LinkedIn) and LinkedIn, which returned 3 of 10 on 28 September and is back to 24 ads for each brand. The 5 October run is now published beside the others so the outage stays on record. Meta active-library counts through ScrapeCreators moved by more than 25% for three advertisers since 28 September: Shopify 6,259 to 4,208, Canva 3,358 to 2,421 and HubSpot 172 to 227. On TikTok through ScrapeCreators, lululemon’s total rose from 3,987 to 5,000, the same figure Canva and Shopify have returned on every run (all three responses say more pages exist). Apollo.io’s fell from 13 to 2. Through Apify, Shopify returned 5 TikTok ads (20 on 28 September). Google’s rounded estimates were identical for nine of ten domains, and Notion went from 18 ads to 17. First-page churn: 95% of Google creative ids were new, 31% to 41% on Meta and 82% on LinkedIn (measured against 28 September, the last run LinkedIn answered for most brands). Apify kept getting slower: the Meta median was 42.6 s and the p95 112 s (lululemon’s call took 111.5 s), and the TikTok median was 22.0 s.

2026-10-05Run/guides/meta-ad-multiple-versions/guides/ad-library-data-fields

Run 2026-10-05: 'This ad has multiple versions' is display_format DCO, with the versions in snapshot.cards

A check of every Meta receipt from the cohort runs of 15, 21 and 28 September 2026 (2,347 ad records, three routes, ten advertisers), with no new provider call. All 948 records with display_format: "DCO" carried their versions as snapshot.cards. On 28 September through ScrapeCreators by page name, 119 of 298 ads were DCO; their 440 cards held 379 distinct versions (text, headline and asset id), 30 ads repeated a card, 118 varied the image or video and 19 the primary text. collation_count (“N ads use this creative and text”) was above 1 on 83 of the 298, 42 of them also DCO; 14 of the 83 came back with their whole group in the same response. The 198 ad ids returned by more than one route agreed on format and card count; the 212 DCO ads seen on both 15 and 28 September kept their card count. Meta’s Archived Ad reference has the versions’ texts as lists but no format, media or collation field. Two screenshot routes returned a blank library page, so the label itself was not captured side by side; the attempts and the two rankable checks cost $0.0052 in total. The fields guide now says its “cards” include multi-version ads, not only carousels. Prompted by an r/FacebookAds question (scout row of 2026-09-15).

2026-09-28Run/guides/ad-library-data-fields

Field guide extended: Meta copy fields and ads relaunched under new ids

Counted on the 21 September receipts, with no new provider call: Meta routes return primary text, headline, call-to-action label and landing URL as separate fields (288, 287, 297 and 297 of 298 ads through ScrapeCreators by page name). 71 of 195 Apify ads carried an unfilled catalogue placeholder. The 298 ScrapeCreators ids held 149 distinct combinations of primary text, headline and landing path, the largest shared by 22 ids. Prompted by a question about storing ad-library copy and deduplicating relaunched ads.

2026-09-28Run/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Weekly re-run 2026-09-28: LinkedIn refused 7 of 10 calls, every other route returned all ten

Third run of cohort v1: 100 calls, 93 returned, $1.58 at list prices. The one route that moved is LinkedIn through ScrapeCreators, which returned 3 of 10: six calls failed with “Failed to get LinkedIn ads: 403” and Semrush’s with a 4-second request timeout, none charged; all seven had returned 24 ads on 21 September, so the route was refused upstream rather than the libraries emptying. Of the three that returned, ClickUp’s LinkedIn total fell from 1,130 to 785 and monday.com’s first page was entirely new (24 of 24 ids). Every Meta, Google and TikTok route returned all ten with the same page sizes, and no field’s presence share moved by ten points or more. Meta’s active-library counts moved by under 25% for every advertiser (largest: Apollo.io 46 to 57, Canva 2,961 to 3,358); Google’s rounded estimates were identical for nine of ten domains and Notion went from 18 ads to 17. TikTok totals through ScrapeCreators moved for HubSpot (206 to 104) and Notion (534 to 672), and ClickUp, absent from TikTok on both earlier runs, returned 5 ads through ScrapeCreators and 1 through Apify. First-page churn was in line with last week: 95% of Google creative ids new, 16% to 18% on Meta. Latency medians moved by under 1.3 s on every route but LinkedIn (7.1 s to 5.1 s, errors included); Meta p95 came down (ScrapeCreators keyword search 11.1 s to 4.4 s, Apify 55 s to 46 s) and Google advertiser lookup p95 went from 2.0 s to 4.7 s.

2026-09-24Run/guides/meta-ad-library-creative-url-lifetime/guides/ad-library-data-fields

Run 2026-09-24: Meta Ad Library creative URLs carry their own expiry, about 106 hours for ordinary ad media

A check of every Meta CDN link in the two cohort runs (15 and 21 September 2026, 30 files each, all three Meta routes) plus a fresh fetch of two advertisers today: 10,355 URLs, every one carrying an oe= expiry in its query string. Ordinary ad images and thumbnails were signed for 104 to 108 hours after the fetch (median 106); videos the same, except a minority (92 of 1,259 on 15 September, 70 of 1,189 on 21 September, 17 of 108 today) signed for about 32 hours; dynamic-creative images and page pictures for about 717 hours. The three routes (ScrapeCreators by page, ScrapeCreators by keyword, Apify) showed the same pattern, so the expiry is Meta’s, not the provider’s. A live probe of 329 sampled links at 2026-09-23T23:37Z returned 403 on all 120 past their decoded expiry and 2xx on all 209 before it. The 1,833 assets present in both cohort runs all came back with a new expiry at the later fetch, so re-fetching an ad refreshes its links. The fresh fetch was two ScrapeCreators company calls through Treg; the account balance read $19.55 before and after. The fields guide now links to the measured number instead of saying only that the URLs expire.

2026-09-21Run/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Weekly re-run 2026-09-21: 100 of 100 returned, first-page churn measured for the first time

Second run of cohort v1, six days after the first: 100 calls, all returned, $1.58 at list prices, no route erroring, page sizes unchanged on every route, and no field’s presence share moved by more than 4 points. TikTok is the only route where an advertiser’s result count changed: monday.com went from zero ads to one and Semrush from one to two through ScrapeCreators, and Grammarly from two to one through Apify. Meta’s active-library counts moved most: Canva 4,350 to 2,961 active ads, Apollo.io 36 to 46, monday.com 667 to 535, Shopify 4,986 to 5,665; TikTok’s total for HubSpot fell from 318 to 206; Google’s rounded library estimates were identical for nine of ten domains and Notion went from 17 to 18 ads; LinkedIn totals moved by under 10% everywhere. First-page churn, measured for the first time: Google and LinkedIn order the first page by most recently served, so 96% of Google creative IDs and 52% of LinkedIn ad IDs were not on the previous first page although the libraries barely changed; on Meta 16% (Apify) to 28% (ScrapeCreators by page name) of first-page ads were new, and ClickUp’s whole first page was a batch of 30 creatives started on 17 September. Latency medians moved by under a second on every route; p95 was noisier (ScrapeCreators Meta keyword search 4.2 s to 11.1 s, SerpApi 3.0 s to 6.7 s, Apify Meta 61 s to 55 s). Housekeeping: the published copy of one 15 September Google advertiser-lookup receipt now masks a personal Gmail address that Google lists as an advertiser name, to the same first-letter rule the enrichment receipts use; role addresses printed in ads are published as returned.

2026-09-15Launch/platforms/meta/platforms/google/choose/ad-library-api/guides/ad-library-data-fields

Advertiser cohort v1 published: 10 advertisers, 10 routes

100 calls, all succeeded, $1.58 at list prices. TikHub’s Creative Center search returned no ads for any brand name and is reported as such. TikTok’s library has no US region, so US-only advertisers return nothing from any route. Platform access terms were quoted from the platforms’ own pages the same day; the weekly re-run and the price checks will log changes here.