# Facebook Ads Transcript - Spoken Hook, CTA, Offer & Angle (`tenfoldfleet/facebook-ads-transcript`) Actor

Get the transcript of Facebook and Instagram video ads from the Meta Ad Library with the spoken hook (first 5 s), CTA, offer and angle. Search by keyword, Page ID or Ad Library link, or monitor new ads only. $25 per 1,000 video ads, $6 per 1,000 image or text ads; no-speech ads free.

- **URL**: https://apify.com/tenfoldfleet/facebook-ads-transcript.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** Social media, AI, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $25.00 / 1,000 video ad transcripts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

*Not affiliated with, endorsed by or sponsored by Meta Platforms, Inc. Facebook and Instagram are trademarks of Meta.*

### What does Facebook Ads Transcript do?

**Facebook Ads Transcript** turns the **video ads** in the public **Meta Ad Library** (facebook.com/ads/library) into text you can study. Give it a **keyword**, an **advertiser Page ID** or an **Ad Library search link**, and for every video ad it returns the **full spoken transcript**, the **spoken hook** (what is said in the first 5 seconds), the **spoken call to action**, the **offer** that is said out loud and a **one-line angle** that names the persuasion idea behind the ad. Each row also carries the ad copy, button, landing page, start date and days running.

Use it as a **Facebook ads transcript API** for creative research: call it from the Apify API, a schedule, Make, Zapier or an AI agent. It needs no Facebook account, login or cookies. If you only need the ad data without transcripts, use [Facebook Ads Library Scraper for Marketers](https://apify.com/tenfoldfleet/facebook-ads-library-scraper), which searches the same way at $6 per 1,000 ads.

### Why use it?

- **Hook swipe file**: collect the first lines your competitors open their video ads with, ready to sort and tag.
- **Offer research**: see which discounts, trials, bundles and guarantees a niche promises out loud.
- **Script writing**: read whole winning scripts instead of watching dozens of videos; long-running ads (`daysRunning`) are usually the ones that work.
- **Angle mapping**: the `angle` column groups ads by the pain or desire they target, so you can spot gaps.
- **New-ads monitor**: schedule it with `onlyNewSince: "lastRun"` and each run returns, and charges for, only the ads that earlier runs did not return.
- **Feed your AI tools**: plain-text transcripts go straight into ChatGPT, Claude or a spreadsheet.

### What data can it extract?

| Field | Example |
|---|---|
| `spokenHook` | "Get retinol results without irritating your skin." |
| `spokenCta` | "Try it for 20% off" |
| `offer` | "20% off" |
| `angle` | "Solution-focused: offers gentle retinol alternative for sensitive skin" |
| `transcript` | Full spoken script of the video |
| `language`, `videoDurationSec` | "en", 24 |
| `pageName`, `pageId` | Advertiser name and Page ID |
| `bodyText`, `title`, `ctaText`, `linkUrl` | Ad copy, headline, button and landing page |
| `startDate`, `daysRunning`, `isActive`, `platforms` | When it started, how long it has run, where it shows |
| `videoUrl`, `videoPreviewImageUrl` | HD video file and thumbnail |
| `adArchiveId`, `adLibraryUrl` | The ad's ID and its Ad Library page |
| `status` | `transcribed`, `ad_row` (image or text ad), `no_audio`, `no_video` or `error` |

### How to get Facebook ad transcripts

1. Open the Actor in Apify Console and type one or more **Search terms** (for example "skincare"), or add **Advertiser Page IDs** or **Ad Library URLs**.
2. Pick the **Country** and leave **Media type** on "Video ads".
3. Set **Max ads per query** (start with 10 to 20).
4. Click **Start**. Each video ad is downloaded, transcribed and analyzed while the search is still loading.
5. Download the results as JSON, CSV or Excel, or read them with the Apify API.

### How much does it cost?

- **$25 per 1,000 video ads** ($0.025 each) with transcript, hook, CTA, offer and angle. One event covers up to 3 minutes of audio; each further started 3 minutes is one more event (most ads are under a minute).
- **$6 per 1,000 image or text ads** ($0.006 each), returned as plain rows when **Media type** is not "Video ads".
- **Free**: video ads with no speech (music only or silent), ads Meta gives no video file for, failed downloads and empty searches.
- With `onlyNewSince: "lastRun"`, ads returned by earlier runs are skipped and not charged.
- On the Apify Free plan the run stops when your monthly free credit runs out. Residential proxy, speech recognition and the AI analysis are included in the price.

### Input

```json
{
    "searchTerms": ["skincare"],
    "mediaType": "video",
    "country": "US",
    "activeStatus": "active",
    "maxAdsPerQuery": 20,
    "onlyNewSince": "lastRun",
    "monitorName": "skincare-competitors",
    "maxMinutesPerVideo": 6,
    "includeTranscriptSegments": false
}
```

`onlyNewSince` also takes a date such as `2026-11-01` to keep only ads that started on or after it.

### Output

One row per ad. Download it as JSON, CSV or Excel.

```json
{
    "adArchiveId": "884215667540987",
    "pageName": "Beauty brand",
    "adFormat": "video",
    "status": "transcribed",
    "spokenHook": "Get retinol results without irritating your skin.",
    "spokenCta": "Try it for 20% off",
    "offer": "20% off",
    "angle": "Solution-focused: offers gentle retinol alternative for sensitive skin",
    "transcript": "Get retinol results without irritating your skin. ...",
    "language": "en",
    "videoDurationSec": 24,
    "bodyText": "Retinol results, zero irritation.",
    "ctaText": "Shop now",
    "linkUrl": "<landing page URL>",
    "startDate": "2026-10-28",
    "daysRunning": 10,
    "isActive": true,
    "platforms": ["facebook", "instagram"],
    "videoUrl": "<signed MP4 link>",
    "adLibraryUrl": "<Ad Library link of the ad>",
    "billedBlocks": 1
}
```

Turn on **Timed transcript segments** to also get `transcriptSegments`: sentences with start and end times in seconds.

### Tips

- **Page ID**: open the advertiser in the Ad Library; the number after `view_all_page_id=` in the address bar is the Page ID. You can paste that whole link into **Advertiser Page IDs**.
- Give each scheduled monitor a **Monitor name**, so changing the search terms later keeps its memory.
- `spokenHook` is copied word for word from the first 5 seconds of speech (finished to the end of the sentence when it ends within 3 more seconds; after a music intro the window starts at the first spoken word). `spokenCta`, `offer` and `angle` come from an AI model reading the transcript and the ad copy.
- Video links from Meta expire within hours, so the Actor downloads each video right after it finds the ad. Save `videoUrl` files you want to keep soon after the run.
- Residential proxy is the default and included in the price; it uses US exits unless you pick another proxy country. Datacenter IPs get only about 30 ads per search.

### FAQ

#### Do I need a Facebook account?

No. The Meta Ad Library is public, and the Actor reads it the way a logged-out visitor does. It never logs in and uses no cookies.

#### Which languages are supported?

Speech is recognized in about 100 languages and detected per ad. `spokenCta` and `offer` stay in the ad's language; `angle` is written in English.

#### What happens with music-only ads?

They come back with `status: "no_audio"` and are not charged. You still get the ad copy, dates and video link.

#### Can I transcribe every ad of one brand?

Yes. Put the brand's Page ID in **Advertiser Page IDs**, set **Active status** to "Active and inactive ads" and **Country** to ALL.

#### Can an AI agent use it?

Yes. Add `https://mcp.apify.com?tools=tenfoldfleet/facebook-ads-transcript` as a remote MCP server in Claude, ChatGPT, Cursor or any MCP client and sign in with your Apify account.

### Disclaimer

This Actor is not affiliated with or endorsed by Meta. It reads only publicly available advertising data from the Meta Ad Library and does not log in. Make sure your use of the data and the transcripts complies with Meta's terms, copyright law and the other laws that apply to you.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [ALDI Australia Scraper - AU Products, Unit Prices & Catalogue](https://apify.com/tenfoldfleet/aldi-australia-scraper) | product |
| [Alibaba Image Search - Reverse Lookup of Suppliers by Photo](https://apify.com/tenfoldfleet/alibaba-image-search) | matched product |
| [Wholesale Suppliers - MOQ & Price Breaks (Alibaba Alternative)](https://apify.com/tenfoldfleet/alibaba-products-scraper) | product |
| [AliExpress Reviews Scraper: Product Feedback & Photos Monitor](https://apify.com/tenfoldfleet/aliexpress-reviews-scraper) | review |
| [AliExpress Keyword Scraper - Exact Sold Counts by Search Term](https://apify.com/tenfoldfleet/aliexpress-search-scraper) | product |
| [Amazon Bestsellers Tracker: New Releases & Rank Changes](https://apify.com/tenfoldfleet/amazon-bestsellers-tracker) | ranked product |
| [Amazon Product Scraper - Details, Prices & Search by ASIN](https://apify.com/tenfoldfleet/amazon-product-scraper) | product |
| [Applicant Tracking Jobs Scraper - Greenhouse, Lever & 6 More](https://apify.com/tenfoldfleet/ats-jobs-scraper) | job posting |
| [Audio Transcription: MP3 & Video Files to Text, SRT, VTT](https://apify.com/tenfoldfleet/audio-transcription) | audio minute transcribed |
| [Backlinks Checker - Referring Domains, Anchors & Domain Rank](https://apify.com/tenfoldfleet/backlinks-checker) | backlink |
| [BBB Scraper: Business Leads, Ratings & New Reviews](https://apify.com/tenfoldfleet/bbb-scraper-leads-reviews) | business |
| [Bilibili Scraper - Videos, Comments, Danmaku & Search](https://apify.com/tenfoldfleet/bilibili-scraper) | video or comment |
| [Businesses Without Websites - Local Leads with Phone & Rating](https://apify.com/tenfoldfleet/businesses-without-websites) | lead |
| [Coles Product Scraper - Australian Supermarket Prices & Deals](https://apify.com/tenfoldfleet/coles-product-scraper) | product |
| [Company Contact Lookup - One Lead Record per Website](https://apify.com/tenfoldfleet/company-contact-finder) | website with contacts |
| [Contact Form Finder: Form Fields, Embed Type & Captcha Flag](https://apify.com/tenfoldfleet/contact-form-finder) | website with contact page or form |
| [CutShort Jobs Scraper - Startup Roles with INR Salary Ranges](https://apify.com/tenfoldfleet/cutshort-jobs-scraper) | job listing |
| [Facebook Ads Library Scraper for Marketers](https://apify.com/tenfoldfleet/facebook-ads-library-scraper) | ad |
| [Facebook Page Contact Finder - Business Leads from Page Links](https://apify.com/tenfoldfleet/facebook-page-contact-finder) | page with contact details |
| [Facebook Reels Scraper: Views & Captions Monitor for Any Page](https://apify.com/tenfoldfleet/facebook-reels-scraper) | reel |
| [Facebook Reels Transcript - Facebook Video to Text, No Login](https://apify.com/tenfoldfleet/facebook-reels-transcript) | reel transcript |
| [Foundit Jobs Monitor: India, Singapore & Malaysia Jobs Scraper](https://apify.com/tenfoldfleet/foundit-jobs-monitor) | job listing |
| [Funding Rounds Scraper - Recently Funded Companies & Investors](https://apify.com/tenfoldfleet/funding-rounds-scraper) | funding round |
| [Google Ads Transparency Center Scraper - Competitor Ads by Site](https://apify.com/tenfoldfleet/google-ads-transparency-scraper) | ad |
| [Google AI Overviews Checker - Citations & Domain Tracker](https://apify.com/tenfoldfleet/google-ai-overviews-checker) | keyword checked |
| [Flights API - Route & Date Fares (Google Flights Alternative)](https://apify.com/tenfoldfleet/google-flights-scraper) | route search |
| [Google Hotels Scraper - Nightly Prices, Stars & Booking Sites](https://apify.com/tenfoldfleet/google-hotels-scraper) | hotel |
| [Google for Jobs Scraper - Openings by City, Pay & Job Board](https://apify.com/tenfoldfleet/google-jobs-scraper) | job listing |
| [Google Keyword Planner Alternative - Ideas, Bids & Volume](https://apify.com/tenfoldfleet/google-keyword-planner) | keyword idea |
| [Google Maps Extractor - Business Leads, Phones & Websites](https://apify.com/tenfoldfleet/google-maps-extractor) | place |
| [Google News Scraper - Articles, Real URLs & Full Text](https://apify.com/tenfoldfleet/google-news-scraper) | article |
| [Google Travel Hotel Rate Tracker - OTA Prices for Every Night](https://apify.com/tenfoldfleet/google-travel-hotel-rate-tracker) | offer |
| [Search Trends by Region & Time - Google Trends Data Scraper](https://apify.com/tenfoldfleet/google-trends-scraper) | keyword |
| [Hirist Jobs Scraper: India Tech Jobs with New-Job Monitor](https://apify.com/tenfoldfleet/hirist-jobs-scraper) | job listing |
| [IIMJobs Jobs Scraper: Search & Monitor Management Roles](https://apify.com/tenfoldfleet/iimjobs-jobs-scraper) | job listing |
| [India Jobs Feed: Hirist, IIMJobs, Foundit, Instahyre & Cutshort](https://apify.com/tenfoldfleet/india-jobs-feed) | job listing |
| [Instagram Reels Analytics - Profile Reel Plays, Likes, Comments](https://apify.com/tenfoldfleet/instagram-reels-analytics) | reel |
| [Instagram Reels Search - Keyword to Top Reels, Plays & Creators](https://apify.com/tenfoldfleet/instagram-reels-search) | reel |
| [Instagram Reels Transcript - Speech to Text for Public Reels](https://apify.com/tenfoldfleet/instagram-reels-transcript) | reel transcript |
| [Instahyre Jobs Monitor: New Tech Jobs in India by Skill](https://apify.com/tenfoldfleet/instahyre-jobs-monitor) | job listing |
| [Keyword Ideas & Related Keywords - Difficulty, Volume & CPC](https://apify.com/tenfoldfleet/keyword-ideas) | keyword idea |
| [Keyword Search Volume, CPC & Difficulty Checker (Bulk)](https://apify.com/tenfoldfleet/keyword-search-volume) | keyword with data |
| [Likee Scraper - Creators by Country, Video Views & Likes](https://apify.com/tenfoldfleet/likee-scraper) | video |
| [LinkedIn Ads Library Scraper - Competitor Ad Copy & Targeting](https://apify.com/tenfoldfleet/linkedin-ad-library-scraper) | ad |
| [LinkedIn Company Posts Monitor: New Posts, No Login](https://apify.com/tenfoldfleet/linkedin-company-posts-monitor) | post |
| [LinkedIn Company Scraper: Firmographics & Recent Posts](https://apify.com/tenfoldfleet/linkedin-company-scraper) | company |
| [Naver Shopping Scraper - Keyword Rank, Prices, Ads & Malls](https://apify.com/tenfoldfleet/naver-shopping-scraper) | product |
| [Pinterest Search Scraper: Pins, Promoted Ads & Shop Trends](https://apify.com/tenfoldfleet/pinterest-search-scraper) | pin |
| [Podcast Transcription: Episodes to Text, SRT & Monitor](https://apify.com/tenfoldfleet/podcast-transcription) | audio minute transcribed |
| [Reddit Brand Monitoring - Keyword Alerts for Posts & Comments](https://apify.com/tenfoldfleet/reddit-brand-monitoring) | mention |
| [Reddit Post Comments Export: Threads to JSON & CSV](https://apify.com/tenfoldfleet/reddit-post-comments-export) | comment |
| [Remote Job Board Scraper - Remote Jobs Aggregator, 7 Sites](https://apify.com/tenfoldfleet/remote-jobs-aggregator) | unique remote job |
| [Reverse Image Search - Find Every Site Using a Photo](https://apify.com/tenfoldfleet/reverse-image-search) | image searched |
| [SEEK Jobs Scraper - Salaries & Hiring Across 8 APAC Job Boards](https://apify.com/tenfoldfleet/seek-job-scraper) | job listing |
| [Semrush API Domain Traffic: Visits, Authority Score, AI Traffic](https://apify.com/tenfoldfleet/semrush-api-domain-traffic) | domain |
| [SEO Agent - AI Keyword Research & Competitor Reports](https://apify.com/tenfoldfleet/seo-agent) | research report |
| [SEO Crawler - Technical SEO Audit Tool & On-Page Checker](https://apify.com/tenfoldfleet/seo-audit-tool) | page audit |
| [SEO Competitor Keywords - Domain Ranked Keywords & Keyword Gap](https://apify.com/tenfoldfleet/seo-competitor-keywords) | keyword |
| [Shopify Inventory Scraper - SKUs, Variants & In-Stock Status](https://apify.com/tenfoldfleet/shopify-products-scraper) | product |
| [Shopify App & Theme Detector - Store Analyzer & Contacts](https://apify.com/tenfoldfleet/shopify-store-analyzer) | shopify store |
| [Sitemap URL Extractor - All URLs from sitemap.xml & robots.txt](https://apify.com/tenfoldfleet/sitemap-url-extractor) | url |
| [Stock Photos & Videos Scraper for Pexels](https://apify.com/tenfoldfleet/stock-photos-scraper) | media item |
| [Website Built With Checker - Find Any Site's CMS & Tech Stack](https://apify.com/tenfoldfleet/tech-stack-detector) | website |
| [Telegram Keyword Search Monitor - New Mentions in Channels](https://apify.com/tenfoldfleet/telegram-keyword-search-monitor) | matching message |
| [Threads Search - Keyword & Profile Posts Scraper (No Login)](https://apify.com/tenfoldfleet/threads-search) | post |
| [TikTok Ads Library Scraper: Competitor Ads in Europe](https://apify.com/tenfoldfleet/tiktok-ads-library-scraper) | ad |
| [TikTok Transcripts - Captions or Speech to Text for Any Video](https://apify.com/tenfoldfleet/tiktok-transcripts) | video transcript |
| [Twitter Video Transcript - X Video to Text & SRT](https://apify.com/tenfoldfleet/twitter-video-transcript) | video transcript |
| [HTML to Text & URL to Markdown - LLM Ready Web Content](https://apify.com/tenfoldfleet/url-to-markdown) | page |
| [Video Transcriber - Any Link to Text, SRT & VTT (7 Platforms)](https://apify.com/tenfoldfleet/video-transcriber-any-url) | video transcribed |
| [Website Traffic Checker - Bulk Domain Traffic Estimate](https://apify.com/tenfoldfleet/website-traffic-checker) | domain with traffic data |
| [WeChat Official Account Articles - Keyword Search to Markdown](https://apify.com/tenfoldfleet/wechat-official-account-articles) | article found |
| [Weibo Scraper - Comment Threads, Hot Search Ranks & User Stats](https://apify.com/tenfoldfleet/weibo-scraper) | comment |
| [Woolworths Product Scraper - AU Shelf Prices, Specials & GTINs](https://apify.com/tenfoldfleet/woolworths-product-scraper) | product |
| [Workday Jobs Scraper - myworkdayjobs.com API with Salary](https://apify.com/tenfoldfleet/workday-jobs-scraper) | job posting |
| [Yahoo Finance Scraper - Quotes, History, Fundamentals & News](https://apify.com/tenfoldfleet/yahoo-finance-scraper) | ticker row |
| [YouTube Channel Email Scraper - Creator Contact Extractor](https://apify.com/tenfoldfleet/youtube-channel-email-scraper) | channel with email |
| [YouTube Livestream & Channel Scraper - Videos, Likes & Stats](https://apify.com/tenfoldfleet/youtube-channel-scraper) | video |
| [YouTube Comments Scraper - Replies, Likes & Sort by Newest](https://apify.com/tenfoldfleet/youtube-comments-scraper) | comment |
| [YouTube Search Scraper: Keyword Video & Shorts Monitor](https://apify.com/tenfoldfleet/youtube-search-scraper) | search result |
| [YouTube Shorts Analytics Scraper - Views, Likes & Hashtags](https://apify.com/tenfoldfleet/youtube-shorts-scraper) | short |
| [YouTube Captions Downloader - Transcript & Subtitles Scraper](https://apify.com/tenfoldfleet/youtube-transcript-scraper) | transcript |
| [YouTube Video Details Lookup: Views, Likes & Tags by URL](https://apify.com/tenfoldfleet/youtube-video-details-lookup) | video details |

# Actor input Schema

## `searchTerms` (type: `array`):

Keywords to search in the Meta Ad Library, one per line (a product, a niche, a brand or a phrase). Each term is one query.

## `pageIds` (type: `array`):

Facebook Page IDs of advertisers, to transcribe the ads of one brand. The ID is the number after view_all_page_id= in an Ad Library link (you can paste that whole link here too).

## `adLibraryUrls` (type: `array`):

Search links copied from https://www.facebook.com/ads/library/ after you set filters there. The filters in the link are used as they are.

## `mediaType` (type: `string`):

Video ads only (the default), or all ads. With all ads, image and text ads come back as plain rows at the lower ad-row price.

## `country` (type: `string`):

Two-letter country code of the market where the ads ran (US, GB, DE, FR, AU, BR...), or ALL for every country.

## `activeStatus` (type: `string`):

Only ads running now, only ads that stopped, or both.

## `exactPhrase` (type: `boolean`):

Match the search term as an exact phrase instead of any of its words.

## `maxAdsPerQuery` (type: `integer`):

Stop each search term, Page or URL after this many ads (up to 1,000). On the Apify Free plan the run also stops when your monthly free credit runs out.

## `onlyNewSince` (type: `string`):

Leave empty for every ad. Type lastRun to get (and pay for) only ads that earlier runs of this monitor did not return: schedule the same input daily or weekly to see each new creative once. Or a date (YYYY-MM-DD) to keep only ads that started on or after it.

## `monitorName` (type: `string`):

Optional name for the lastRun memory, for example competitors-skincare. Without it the memory is tied to the exact search terms, Page IDs and filters.

## `maxMinutesPerVideo` (type: `integer`):

Transcribe at most this many minutes of each video. One video ad event covers 3 minutes of audio; each further started 3 minutes is one more event. Most ads are under 1 minute; the limit is 10 minutes.

## `language` (type: `string`):

Leave on auto to detect it per ad, or give a two-letter code (en, es, de, fr, pt...) when you know it.

## `includeTranscriptSegments` (type: `boolean`):

Also return the transcript as sentences with start and end times in seconds.

## `maxConcurrency` (type: `integer`):

How many queries to load at the same time. Keep it low: Meta slows down sessions that load too fast.

## `proxyConfiguration` (type: `object`):

Residential proxy is the default and its cost is included in the price. Datacenter IPs only get about 30 ads per query before Meta limits them.

## Actor input object example

```json
{
  "searchTerms": [
    "skincare"
  ],
  "mediaType": "video",
  "country": "US",
  "activeStatus": "active",
  "exactPhrase": false,
  "maxAdsPerQuery": 10,
  "maxMinutesPerVideo": 6,
  "language": "auto",
  "includeTranscriptSegments": false,
  "maxConcurrency": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "skincare"
    ],
    "maxAdsPerQuery": 10,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/facebook-ads-transcript").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["skincare"],
    "maxAdsPerQuery": 10,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/facebook-ads-transcript").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "skincare"
  ],
  "maxAdsPerQuery": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call tenfoldfleet/facebook-ads-transcript --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/facebook-ads-transcript"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/xFZuhcvPSfykMRpsc/builds/sby81KPLlnnfJvo2m/openapi.json