input | object | string | Input The brand as parsed: { name, domain?, facebookPageId?, linkedinCompanyId?, linkedinCompany?, tiktokAdvertiser?, googleAdvertiserId? }. |
recordType | string | Record type platform = one ad library's snapshot (charged platform-snapshot); summary = the brand's cross-platform summary (not charged). e.g. "platform" |
brand | string | Brand Brand name. e.g. "Nike" |
platform | string | Ad library meta | google | tiktok | linkedin (platform records). |
platformName | string | Library name Meta (Facebook, Instagram) | Google Ads Transparency | TikTok | LinkedIn. |
query | object | Query { by, value }: what the library was asked (pageId, companyName, advertiserId, domain, advertiserName, companyId or company). |
resolvedAdvertisers | array | Google advertisers Google only, for a brand given by name: the advertisers the lookup found ({ advertiserId, name, region, adsEstimate }). |
advertiser | string | null | Advertiser Advertiser name as the library shows it on the ads. |
advertiserId | string | null | Advertiser ID Facebook page ID, Google advertiser ID or LinkedIn company ID when the snapshot was fetched by ID. |
adsFetched | integer | Ads fetched Distinct ads on the fetched pages. |
totalAdsEstimate | integer | null | Total ads (library) The library's own total for the query, when it reports one. |
adsFound | integer | Ads in snapshot Ads the snapshot covers (adsFetched minus ads known to be over when activeOnly is on). |
activeAds | integer | Active ads Meta: the library's active flag. Google, TikTok, LinkedIn: last shown within 7 days. |
newAds7d | integer | New ads (7 days) Ads first seen in the last 7 days. |
newAds30d | integer | New ads (30 days) Ads first seen in the last 30 days. |
firstSeen | string | null | First seen Earliest start date among the ads (ISO). |
lastSeen | string | null | Last seen Latest date an ad was shown (ISO; now for ads Meta marks active). |
longestRunningDays | integer | null | Longest running (days) Platform records: the longest an ad has run, in days. |
medianDaysRunning | integer | null | Median running (days) Median running time of the ads, in days. |
formats | object | Formats Ads per format: image, video, carousel, text, dynamic, other, unknown. |
ctas | object | Calls to action Ads per call-to-action text (Meta, LinkedIn). |
landingDomains | array | Landing domains [{ domain, ads }]: the registrable domains the ads link to, most used first. |
countries | array | Countries Countries as the library reports them (ISO codes on Meta and Google, names on LinkedIn). |
publisherPlatforms | array | Placements Meta placements: facebook, instagram, messenger, audience_network. |
offers | array | Offers [{ offer, ads }]: offer phrases found in the ad copy (e.g. 30% off, free shipping, free trial, sale, price mention). |
topCreatives | array | Top creatives Running ads first, then the longest running: { adId, url, advertiser, format, text, headline, cta, landingUrl, landingDomain, imageUrls, videoUrls, thumbnailUrl, firstSeen, lastSeen, isActive, daysRunning, countries, publisherPlatforms, reach }. |
ads | array | All ads Every ad of the fetched pages, same shape as topCreatives (only with includeAllAds). |
pagesFetched | integer | Pages fetched Library pages read for this snapshot. |
extraPagesCharged | integer | Extra pages charged extra-page events charged for this library (further pages and the Google advertiser lookup). |
domain | string | null | Domain Summary records: the brand's website domain. |
platformsRequested | array | Libraries requested Summary records. |
platformsWithAds | array | Libraries with ads Summary records: libraries where the brand has ads. |
platformsFailed | array | Libraries failed Summary records: libraries without a snapshot (error or budget; not charged). |
totalAdsFound | integer | Total ads Summary records: ads across all snapshots. |
totalActiveAds | integer | Total active ads Summary records. |
longestRunning | object | null | Longest running Summary records: { platform, days } of the longest-running ad. |
sharedLandingDomains | array | Shared landing domains Summary records: [{ domain, ads, platforms }] for domains the brand advertises on more than one library. |
topLandingDomains | array | Top landing domains Summary records: [{ domain, ads }] across all libraries. |
platforms | object | Per library Summary records: { <library>: { status, adsFound, activeAds, charged } }. |
snapshotsCharged | integer | Snapshots charged Summary records: platform-snapshot events charged for the brand. |
status | string | Status ok | not_found | error | skipped_budget | skipped_free_plan | skipped_unmetered e.g. "ok" |
charged | boolean | Charged Whether this record incurred a pay-per-event charge. |
chargedEvent | string | Charged event platform-snapshot (or extra-page when only the Google lookup was charged); present only when charged. |
chargedCount | integer | Events charged Events actually charged when a charge came back short (present only then). |
source | string | Source scrapecreators |
fetchedAt | string | Fetched at ISO timestamp. |
error | object | Error { code, message, provider?, status? } when status is not ok: no_ads, no_advertiser, not_found, budget_exhausted, aborted; upstream codes: auth, insufficient_credits, rate_limit, timeout, network, server, client, invalid_response; runtime codes: free_plan_limit, unmetered, charge_failed, record_too_large, invalid_record, dataset_push_failed. |
warnings | array | Warnings E.g. a library skipped for the budget, paging stopped by the time limit, the free-plan page limit. |
raw | string | Raw pages The unmodified library pages (only with includeRaw). |