Skip to main content
GET
Ad Transcript
💳 1 credit per request — but you are only charged when a transcript is returned. If the ad has no available transcript, the request costs 0 credits.
Get the transcript for a Facebook Ad Library video ad. Provide either the ad id or the ad url.

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

id
string

Facebook Ad ID (provide either id or url)

Example:

"1020359190509080"

url
string

Facebook Ad URL (provide either id or url)

Example:

"https://www.facebook.com/ads/library?id=1020359190509080"

Response

Successful response

Key Response Fields:

  • data.transcript: The transcript text extracted from the ad's video
  • data.transcript_available: Whether a transcript was available (true when one is returned). Credits are only charged when a transcript is returned.
  • data.ad_id: The Facebook Ad ID
  • data.url: The Facebook Ad Library URL for the ad