facebook

Adlibrary › Ad › Transcript

Returns the spoken words of a Facebook Ad Library video ad, from Facebook's captions when available or transcribed from the video itself.

Use it when you need what an ad says out loud; adlibrary/ad returns the creative and spend but not the speech.

100 credits per call.

get/v1/facebook/adlibrary/ad/transcript

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/facebook/adlibrary/ad/transcript
  • Auth: API key in header x-api-key

Query parameters

idstring

Facebook Ad Library ad ID. Ad ids rotate as campaigns end, so take a current one from /v1/facebook/adlibrary/company/ads rather than reusing an old one. Provide at least one of: id, url.

urlstring

Facebook Ad Library URL for the ad. A page URL is rejected with a 400. Provide at least one of: id, url.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

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