{"uid":"cap_R2McRoYhlJjLW7YLKUrKn","slug":"gedx402-social-tiktok-ad-library-search-c9f194cd","name":"GEDX402 Social – TikTok Ad Library Search","description":"SociaVault social data ingest — profile, posts, transcript, and full API proxy. One x402 payment per outcome.","url":"https://social.gedx402.com/v1/sociavault/tiktok-ad-library/search","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"likes":{"type":"string"},"limit":{"type":"integer"},"query":{"type":"string"},"cursor":{"type":"integer"},"period":{"type":"string"},"region":{"type":"string"},"duration":{"type":"string"},"industry":{"type":"string"},"order_by":{"type":"string"},"ad_format":{"type":"string"},"objective":{"type":"string"},"ad_language":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"success":true,"provider":"sociavault"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","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.014/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pjtbpXboz3LwPtpKO3SBy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search the TikTok Ad Library for ads by query, region, industry, format, and other filters via a paid proxy.","exampleAgentPrompt":"Search the TikTok Ad Library via SociaVault for up to 20 ads about 'weight loss supplements' targeting the US region in the health industry, ordered by likes, covering the last 30 days.","exampleUseCases":null,"resultDescription":"A JSON object with a 'data' field containing matching TikTok ad records (metadata, creatives, targeting info), a 'success' boolean, and provider attribution ('sociavault'). Results are paginated and support cursor-based navigation.","failureModes":["Payment not processed — x402 micropayment fails, endpoint returns 402","Invalid region or ad_format enum value — returns error or empty data","Query returns zero results for niche or overly specific search terms","Cursor out of range — pagination fails with empty or error response","Rate limiting or upstream TikTok Ad Library API unavailability"],"whenToPreferThis":"Use this endpoint when you need programmatic access to TikTok Ad Library data — for competitive ad research, trend analysis, or creative benchmarking — and want a simple per-call micropayment model without subscription overhead. Prefer over manual TikTok Ad Library browsing or other social data providers when you need structured JSON output with flexible filtering by region, industry, format, and objective.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:12.604Z","isFirstParty":false}