{"uid":"cap_s0Q4TibjoDZpVa98VgBU_","slug":"facebook-ad-library-get-single-ad-by-archive-id-or-url-c5b0aaf8","name":"Facebook Ad Library - Get Single Ad by Archive ID or URL","description":"Get a single Facebook Ad Library ad by archive id or public Ad Library URL.","url":"https://api.socialfetch.dev/v1/facebook/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 Facebook Ad Library URL for the ad."},"adId":{"type":"string","maxLength":4096,"minLength":1,"description":"Facebook Ad Library archive id for the ad."},"trim":{"anyOf":[{"type":"boolean"},{"enum":["0","1","true","false"],"type":"string"}],"description":"When true, requests a smaller payload before normalization."},"includeTranscript":{"anyOf":[{"type":"boolean"},{"enum":["0","1","true","false"],"type":"string"}],"description":"When true, includes a plain-text transcript when available for the ad video."}}}},"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_jKe9mpnW_G5ovl03gkc-Y","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 detailed data for a single Facebook Ad Library ad, given its archive ID or public Ad Library URL.","exampleAgentPrompt":"Can you pull the details for this Facebook Ad Library ad — https://www.facebook.com/ads/library/?id=1234567890 — and include the video transcript if there is one?","exampleUseCases":[{"title":"Verify competitor ad creative and messaging","prompt":"Can you look up this Facebook ad from our competitor and give me the full details on what they're running, the advertiser info, and any video transcript so I can see exactly what they're saying?"},{"title":"Research political ad spending and targeting","prompt":"I found this political ad in the Facebook Ad Library — can you pull all the structured data on it, including who's paying for it, the targeting details, and the spend information?"},{"title":"Audit brand safety for ad placements","prompt":"We need to check this specific ad that appeared in our feed — can you fetch the metadata and creative content from the Ad Library using this archive ID so we can verify the advertiser and see the actual ad content?"}],"resultDescription":"Returns structured data about a single Facebook Ad Library ad, including creative content, advertiser info, ad metadata, and optionally a plain-text transcript of the video if available. A trim option reduces payload size.","failureModes":["Invalid or missing archive ID and URL returns an error","Ad not found in the Ad Library (removed or non-existent)","Rate limiting if too many requests are made in a short window","Payment failure via x402 protocol blocks the request","Ad Library URL is malformed or unrecognizable","Video transcript unavailable even when includeTranscript is true"],"whenToPreferThis":"Use this endpoint when you have a specific Facebook Ad Library archive ID or public Ad Library URL and need structured metadata and creative data for that one ad. Prefer this over search endpoints when the exact ad is already known. Best for ad intelligence, political ad research, competitive analysis, or verifying ad details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:58:00.184Z","isFirstParty":false}