FeedMCP

Data APIs / Meta Ad Library

Meta ad transcript API

What is said in a Meta Ad Library video ad, as one text; captions first, AI transcription for videos up to two minutes otherwise.

Item Value
Endpoint GET https://api.feedmcp.com/v1/meta/ads/transcript/get
ID meta.ads.transcript.get
Price $0.002 / call
Returns One Transcript object
Auth Authorization: Bearer $FEEDMCP_API_KEY

Uses the ad’s captions first, then AI transcription for videos up to two minutes. Image ads and videos without speech return not found, free of charge.

Parameters

Name Type Required Description
id string one of Library ID (the number after id=)
url string one of Video or post link

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.item is one Transcript object, with the same fields on every platform:

Field Type Description
id string The video or post ID, as the platform’s detail endpoint takes it
platform string Platform
url string | null Video or post link
language string | null Caption language (when the platform says)
text string The full transcript
segments {start, end, text}[] Timed segments in seconds (YouTube, TikTok, Instagram and Reddit; empty elsewhere)
duration_seconds number | null Video length in seconds
source 'captions' | 'ai' | null captions (the platform’s own), ai (AI transcription) or null (not known)

When you are charged

$0.002 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/meta/ads/transcript/get?id=974466855339122" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/meta/ads/transcript/get",
    params={"id": "974466855339122"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/meta/ads/transcript/get?id=974466855339122", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "meta.ads.transcript.get",
  "params": {
    "id": "974466855339122"
  },
  "max_price": "0.002"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "item": {
      "id": "974466855339122",
      "platform": "meta",
      "url": "https://www.facebook.com/ads/library/?id=974466855339122",
      "language": null,
      "text": "Try our new tent this weekend.",
      "segments": [],
      "duration_seconds": 44.1,
      "source": null
    }
  },
  "page": null,
  "warnings": [],
  "meta": {
    "endpoint": "meta.ads.transcript.get",
    "platform": "meta",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Meta Ad Library endpoints

Questions

How much does the Meta ad transcript endpoint cost?

$0.002 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

An ad is the number after id= in a library link; an advertiser is its Facebook page ID (advertiser.id in an ad, or use the advertiser search).

How do I use it from an AI?

Install the MCP server and ask; your AI calls meta.ads.transcript.get.