{"uid":"cap_7-Ga5GAvtbLJ9PW2z-cxc","slug":"tiktok-ads-library-scraper-9dde6aae","name":"TikTok Ads Library Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/tiktok-ads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"adIds":{"type":"array","description":"Fetch these public ad IDs directly instead of searching."},"query":{"type":"string","description":"Words to find in public ad text or advertiser names."},"sortBy":{"enum":["last_shown_date,desc","last_shown_date,asc","create_time,desc","create_time,asc","impression,desc","impression,asc"],"type":"string","default":"last_shown_date,desc","description":"Order of public search results."},"country":{"enum":["GB","AT","BE","BG","CH","CY","CZ","DE","DK","EE","ES","FI","FR","GR","HR","HU","IE","IS","IT","LI","LT","LU","LV","MT","NL","NO","PL","PT","RO","SE","SI","SK","TR","ALL"],"type":"string","default":"GB","description":"Country where ads were shown. All requires a search query."},"endDate":{"type":"string","description":"Latest date in YYYY-MM-DD. Defaults to today."},"maxItems":{"type":"integer","default":60,"minimum":0,"description":"Stop after this many unique ads. Zero means no item cap."},"maxPages":{"type":"integer","default":5,"minimum":0,"description":"Maximum search requests, up to 300. The page-based path uses them for date windows."},"startDate":{"type":"string","description":"Earliest first-shown date, in YYYY-MM-DD. Defaults to 30 days ago."},"quickSearch":{"type":"boolean","default":false,"description":"Skip ad detail requests. Targeting and advertiser fields may then be empty."},"advertiserName":{"type":"string","description":"Search for ads associated with this advertiser name; takes priority over query."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"adId":null,"adUrl":null,"adType":null,"status":null,"adTitle":null,"auditStatus":null,"rejectionInfo":null,"sorAuditStatus":null}],"product":"tiktok-ads"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_28FVTvQLBQQHsMrD8S-rL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and returns structured public TikTok ad data by keyword, advertiser name, ad ID, country, and date range.","exampleAgentPrompt":"Search the TikTok public ad library for ads from 'Nike' in Germany over the last 30 days, sorted by most recent, and return up to 60 ads with full details.","exampleUseCases":[{"title":"Competitor ad monitoring","prompt":"Pull all public TikTok ads from 'Shein' shown in France since January 1st 2025, sorted by impression count descending, and give me up to 100 results."},{"title":"Keyword-based ad research","prompt":"Search TikTok's ad library for ads containing the word 'crypto' in the UK, sorted by most recently shown, going back to 2024-12-01, and cap it at 50 ads."},{"title":"Lookup specific TikTok ads","prompt":"Fetch me the full details for these specific TikTok ad IDs: 1234567890, 9876543210, and 1122334455 from the public ad library."}],"resultDescription":"Returns a JSON object with a count of matched ads and an array of ad items, each containing fields such as adId, adUrl, adType, status, adTitle, auditStatus, rejectionInfo, and sorAuditStatus. Failed or empty result sets are not charged.","failureModes":["No ads found matching query or filters — returns empty items array (not charged)","Invalid country code returns validation error","Invalid date format for startDate or endDate","Ad IDs not found in public library return null fields","Rate limits or TikTok library access restrictions may reduce results","maxPages set too low may truncate paginated results"],"whenToPreferThis":"Choose this endpoint when you need structured, pay-per-result access to TikTok's public ad library without building your own scraper. Ideal for competitive ad intelligence, brand monitoring, and ad transparency research across European countries. Prefer this over manual browsing of TikTok's Ad Library when you need machine-readable JSON output, filtering by date range and country, or bulk retrieval by ad ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:55:57.914Z","isFirstParty":false,"canonicalSlug":"tiktok-ads-library-scraper-9dde6aae"}