[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Facebook Ad Library video transcript](https://spiral.ai/integrations/gemini-cli/facebook-ad-library-video-transcript)

# How to Use Facebook Ad Library video transcript in Gemini CLI

Get the transcript text of a Facebook Ad Library video ad, using native captions or AI transcription. Use it to review spoken hooks, offers, and calls to action; unavailable transcripts return null.

|  |  |
| --- | --- |
| Model | Facebook Ad Library video transcript |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Facebook Ad Library video transcript in Gemini CLI

- Use Facebook Ad Library video transcript for https://www.facebook.com/ads/library?id=1020359190509080 and save the returned text in this project's ad research folder.
- Use Facebook Ad Library video transcript for https://www.facebook.com/ads/library?id=702369045530963 and add its retrieved text to our script search index.
- Use Facebook Ad Library video transcript for ad 1020359190509080 and add a review view that separates the transcript from an extracted opening hook and closing call to action.
- Use Facebook Ad Library video transcript for ad 702369045530963 and export its text plus any spoken event references to a CSV in this project.
- Use Facebook Ad Library video transcript for ads 1020359190509080 and 702369045530963, then generate a Markdown comparison of spoken benefits, offers, and closing instructions.

## How to set up Facebook Ad Library video transcript in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Facebook Ad Library video transcript**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/facebook-adlibrary-ad-transcript",
    "input": {
      "id": "1020359190509080"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Facebook Ad Library video transcript on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Facebook Ad Library video transcript tools and prices

- [Facebook Ad Library · Ad Transcript](https://spiral.ai/tools/scrapecreators/scrapecreators/facebook-adlibrary-ad-transcript) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| id |  | — | Facebook Ad Id |
| url |  | — | Facebook Ad URL |
| cache_max_age | 1d, 3d, 7d, 14d, 30d | — | If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching) |

## What can you do with Facebook Ad Library video transcript in Gemini CLI?

Build a searchable ad script archive from Facebook Ad Library transcript text. A coding agent can add transcript retrieval, text search, and a review screen that handles unavailable transcripts.

### Compare opening hooks

Extract the opening words from selected video ad transcripts and compare how each script introduces a problem, product, or offer.

### Review spoken offers

Pull offer language, eligibility conditions, and deadlines from selected scripts into a review table, keeping each finding tied to its ad.

### Build a searchable script archive

Index retrieved transcript text so a creative team can find ads that mention particular products, objections, or benefits.

### Prepare claims for review

Extract spoken product claims and guarantees for a human reviewer, preserving the wording separately from the agent's interpretation.

### Compare calls to action

Compare the closing instructions in selected video scripts, such as visiting a website, booking a demonstration, or attending an event.

### Draft a translation brief

Translate retrieved ad speech for an internal creative review and identify product names or phrases that need a translator's attention.

### Summarize creative themes

Turn a selected set of transcripts into a brief covering repeated problems, benefits, objections, and offers, with supporting passages.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Facebook Ad Library video transcript in other agents

- [Amp](https://spiral.ai/integrations/amp/facebook-ad-library-video-transcript)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/facebook-ad-library-video-transcript)
- [Claude](https://spiral.ai/integrations/claude-desktop/facebook-ad-library-video-transcript)
- [Claude Code](https://spiral.ai/integrations/claude-code/facebook-ad-library-video-transcript)
- [Cline](https://spiral.ai/integrations/cline/facebook-ad-library-video-transcript)
- [Codex](https://spiral.ai/integrations/codex/facebook-ad-library-video-transcript)
- [Cursor](https://spiral.ai/integrations/cursor/facebook-ad-library-video-transcript)
- [Devin](https://spiral.ai/integrations/devin/facebook-ad-library-video-transcript)
- [dots](https://spiral.ai/integrations/dots/facebook-ad-library-video-transcript)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/facebook-ad-library-video-transcript)
- [Gemini](https://spiral.ai/integrations/gemini/facebook-ad-library-video-transcript)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/facebook-ad-library-video-transcript)
- [goose](https://spiral.ai/integrations/goose/facebook-ad-library-video-transcript)
- [Grok](https://spiral.ai/integrations/grok/facebook-ad-library-video-transcript)
- [Grok Build](https://spiral.ai/integrations/grok-build/facebook-ad-library-video-transcript)
- [Hermes](https://spiral.ai/integrations/hermes/facebook-ad-library-video-transcript)
- [Instinct](https://spiral.ai/integrations/instinct/facebook-ad-library-video-transcript)
- [Manus](https://spiral.ai/integrations/manus/facebook-ad-library-video-transcript)
- [Muse](https://spiral.ai/integrations/muse/facebook-ad-library-video-transcript)
- [Muse Code](https://spiral.ai/integrations/muse-code/facebook-ad-library-video-transcript)
- [n8n](https://spiral.ai/integrations/n8n/facebook-ad-library-video-transcript)
- [Notion](https://spiral.ai/integrations/notion/facebook-ad-library-video-transcript)
- [OpenClaw](https://spiral.ai/integrations/openclaw/facebook-ad-library-video-transcript)
- [opencode](https://spiral.ai/integrations/opencode/facebook-ad-library-video-transcript)
- [Perplexity](https://spiral.ai/integrations/perplexity/facebook-ad-library-video-transcript)
- [Raycast](https://spiral.ai/integrations/raycast/facebook-ad-library-video-transcript)
- [VS Code](https://spiral.ai/integrations/vscode/facebook-ad-library-video-transcript)
- [Windsurf](https://spiral.ai/integrations/windsurf/facebook-ad-library-video-transcript)
- [Zapier](https://spiral.ai/integrations/zapier/facebook-ad-library-video-transcript)

## More Gemini CLI guides

- [Facebook Ad Library company ads](https://spiral.ai/integrations/gemini-cli/facebook-ad-library-company-ads)
- [Facebook Page details](https://spiral.ai/integrations/gemini-cli/facebook-page-details)
- [Facebook Ad Library advertisers](https://spiral.ai/integrations/gemini-cli/facebook-ad-library-advertisers)
- [Facebook Page photos](https://spiral.ai/integrations/gemini-cli/facebook-page-photos)
- [Facebook Ad Library ads](https://spiral.ai/integrations/gemini-cli/facebook-ad-library-ads)
- [Facebook city events](https://spiral.ai/integrations/gemini-cli/facebook-city-events)

## Questions about Facebook Ad Library video transcript in Gemini CLI

**Can Gemini CLI use Facebook Ad Library video transcript?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Facebook Ad Library video transcript like any built-in tool.

**How much does Facebook Ad Library video transcript cost in Gemini CLI?**

$0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need a ScrapeCreators account to use Facebook Ad Library video transcript in Gemini CLI?**

No. Spiral runs Facebook Ad Library video transcript on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Facebook Ad Library video transcript in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Facebook Ad Library video transcript runs?**

Facebook Ad Library video transcript runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Where does the transcript come from?**

ScrapeCreators returns native captions or an AI transcript from a Facebook video ad. The output is transcript text for the video's speech.

**Does every ad have a transcript?**

No. The documented transcript value is null when a transcript is unavailable, so an Ad Library listing does not guarantee readable speech text.

**What is the video length limit?**

The standard AI transcription boundary is two minutes. ScrapeCreators documents separate permission for AI transcription beyond that length; this boundary concerns AI transcription, rather than native captions.

**How fresh is the source data?**

ScrapeCreators says live requests fetch the latest available Ad Library information when requested. That describes retrieval freshness, rather than a fixed publication or caption update schedule.

**Can I retrieve years of political ad scripts?**

Meta retains political, electoral, and social issue ads in its public Ad Library for seven years. That is an ad retention policy: the transcript endpoint can still return null for an unavailable transcript.

