{"uid":"cap_Has80iqpd-f28Lg86Tz9v","slug":"gedx402-social-tiktok-ad-library-ad-lookup-67c8a472","name":"GEDX402 Social – TikTok Ad Library Ad Lookup","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/ad","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"ad_id":{"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_43h2lvJiJND7om3V76Xsv","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":"Fetches details for a specific TikTok ad from the TikTok Ad Library by ad ID via the SociaVault proxy, paid per call with x402.","exampleAgentPrompt":"Can you pull the TikTok Ad Library record for ad ID '7380123456789012345' — I want to see what creative and targeting info is available for it?","exampleUseCases":null,"resultDescription":"A JSON object containing the ad's data from the TikTok Ad Library as proxied through SociaVault, including ad metadata and a success flag; the 'data' field holds the ad record details.","failureModes":["Invalid or non-existent ad_id returns empty data or error in the response body","Payment failure via x402 results in 402 response before data is returned","TikTok Ad Library rate limits or upstream unavailability cause failures","Missing ad_id parameter may result in bad request error"],"whenToPreferThis":"Use this endpoint when you need to retrieve a specific TikTok ad's details from the TikTok Ad Library by its ad ID, especially in pay-per-call agent workflows using x402 micropayments where you only pay for what you use.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:51:15.151Z","isFirstParty":false}