Facebook

Facebook

Video / Ad Transcript

per_call

Transcribes Facebook video posts and ad creatives into time-coded text with a detected language. Combine it with the Ad Library services to analyse messaging, hooks and offers across a competitor's whole video ad set.

What you get

Each call returns one transcript record. There is no pagination.

Endpoint

GET /v1/facebook/video-ad-transcript

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

url
required
string

The public Facebook video, reel or ad URL to resolve.

fresh
optional
enum

Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.

One of: true, 1, false, 0

Example request

Live call. Successful calls are charged; failed and empty results are not.

curl
curl "https://fastfetchz.com/v1/facebook/video-ad-transcript?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1473074887982541%2F" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "Facebook",
    "name": "Video / Ad Transcript",
    "slug": "video-ad-transcript"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "source_url": "nasa",
    "language": "en",
    "duration_sec": 184,
    "segments": [
      {
        "start": 0,
        "end": 4.2,
        "text": "Welcome back to the channel."
      },
      {
        "start": 4.2,
        "end": 11.8,
        "text": "Today we are looking at sandbox transcript output."
      },
      {
        "start": 11.8,
        "end": 19.4,
        "text": "Every segment includes start and end timestamps."
      }
    ],
    "text": "Welcome back to the channel. Today we are looking at sandbox transcript output. Every segment includes start and end timestamps."
  }
}

Limits

  • Maximum per call: 1 transcripts.
  • Minimum per call: 1 transcript — a target with less data returns fewer transcripts, and an empty result is still a successful call.
  • Each call fetches a full page of up to 1 and costs the same either way. Pass limit to receive fewer than that in the response.
  • This endpoint returns a single record per call and is not paginated.

What this costs in practice

10,000 transcripts = 10,000 calls × 1 credits per call = 10,000 credits = $0.00

Priced at the Custom pack rate: 1,000,000 credits for $0.00.

Open in the pricing calculator

Error codes

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.