{"uid":"cap_kMTc6e1g3DbTGlbkLsCm_","slug":"socialfetch-tiktok-ad-library-get-ad-by-id-or-url-d0393330","name":"SocialFetch TikTok Ad Library - Get Ad by ID or URL","description":"Get a single TikTok Ad Library or Top Ads creative by ad id or public ad URL.","url":"https://api.socialfetch.dev/v1/tiktok/ad-library/ads","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"url":{"type":"string","maxLength":4096,"minLength":1,"description":"Public TikTok Ad Library or Top Ads detail URL for the ad."},"adId":{"type":"string","maxLength":4096,"minLength":1,"description":"TikTok Ad Library or Top Ads ad id."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_6GB-JmwkvGLQd8usukNP5","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 a single TikTok Ad Library or Top Ads creative by ad ID or public ad URL.","exampleAgentPrompt":"Can you pull the details and creative for this TikTok Ad Library ad? Here's the URL: https://library.tiktok.com/ads/detail/?ad_id=1234567890","exampleUseCases":null,"resultDescription":"Returns structured data about a single TikTok ad creative, including ad content, metadata, and associated details sourced from the TikTok Ad Library or Top Ads platform.","failureModes":["Invalid or malformed ad ID returns an error response","Ad URL not recognized as a TikTok Ad Library or Top Ads URL","Ad no longer available or removed from TikTok Ad Library","Missing both adId and url query parameters","Rate limiting or payment failure for the $0.014 USDC per-call fee"],"whenToPreferThis":"Use this endpoint when you need to retrieve details about a specific known TikTok ad by its ID or public URL, particularly from TikTok's Ad Library or Top Ads section. Prefer this over search endpoints when you already have the ad identifier or direct URL and want full creative details rather than a list of results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:46.195Z","isFirstParty":false}