Meta Ads Library

Ad video transcript

Return plain speech text from the first available primary or carousel video. Image-only ads and videos without detected speech return transcript_available=false. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/facebook/adLibrary/ad/transcript

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/facebook/adLibrary/ad/transcript
  • Auth: API key in header x-api-key

Query parameters

idstring

Exact numeric archive ID, supplied as a string. Use id or url, not both.

urlstring

Canonical HTTPS facebook.com/ads/library/?id= URL.

trim'true' | 'false'

Use the compact field projection while preserving creative snapshots and regional transparency.

includeTranscript'true' | 'false'

Recognize speech in the first available primary or carousel video. Requires configured local Whisper and FFmpeg.

cache_max_age'1d' | '3d' | '7d' | '14d' | '30d'

Accepted freshness hint; every response is fetched live and returns cached=false.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.