How to Use Facebook Ad Library ad creative and status in Gemini CLI
Fetch a specific Meta Ad Library ad’s text, media, destination link, advertiser, dates, and active status. Use it to inspect a saved ad or compare later snapshots of the same ad.
Prompts to try with Facebook Ad Library ad creative and status in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Facebook Ad Library ad creative and status for ad 702369045530963, documented as a Porto Montenegro ad, and add a review table to this project with its returned advertiser, text, media, destination link, and status. If unavailable, show that result.
Use Facebook Ad Library ad creative and status for lululemon ad 1470798047609348 and save the returned creative cards in this project's research data, preserving each title and destination link.
Use Facebook Ad Library ad creative and status for KURU Footwear ad 1339489931715040 and add its returned advertiser, dates, and active status to this project's ad review screen.
Use Facebook Ad Library ad creative and status for Porto Montenegro ad 702369045530963 and compare the response with any saved response for that ID in this project. Show changes to text, links, and status.
Use Facebook Ad Library ad creative and status for lululemon ad 1470798047609348 and build a creative card viewer in this project using the returned titles and media. Show unavailable content explicitly.
How to set up Facebook Ad Library ad creative and status in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Facebook Ad Library ad creative and status
One request; the result comes back by polling or a webhook.
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", "input": { "id": "702369045530963" } }'
Then paste one of the prompts above: Gemini CLI finds Facebook Ad Library ad creative and status on Spiral, shows the price and runs it.
Facebook Ad Library ad creative and status providers and prices
Spiral runs Facebook Ad Library ad creative and status through ScrapeCreators. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Trim | on or off | Set to true for a trimmed down version of the response | |
| Cache max age | 1d, 3d, 7d, 14d, or 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 (1 credit; default short AI is included; allow_long_transcription=true adds 10 credits per started minute to the existing base cost). See the Caching page for details. | |
| Get transcript | on or off | Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. |
Every API field of Facebook Ad Library · Ad Details is on its tool page: open its card above.
What can you do with Facebook Ad Library ad creative and status in Gemini CLI?
Build an ad review table from saved Meta Ad Library links, with copy, media, destination links, and status. Compare stored responses to show which creative details changed.
Creative research notes
Turn a saved public business ad into a brief covering its message, media format, advertiser, and destination link.
Offer change monitoring
Compare successive snapshots of known business ads and flag changes to offer wording or destination URLs.
Campaign status reports
Recheck saved ad IDs and report their returned active status and dates, allowing for Meta’s 24-hour update window.
Creative card review
Inspect the titles and links across an ad’s creative cards before writing a summary that could overlook alternate messages.
Destination link inventory
Extract the destination links from selected public business ads and organize them by advertiser and advertised offer.
Client research handoffs
Prepare a comparison of selected competitor ads using their copy, media, dates, and status, without ranking them by unobserved sales performance.
More on Facebook Ad Library ad creative and status and Gemini CLI
Facebook Ad Library ad creative and status in other agents
Questions about Facebook Ad Library ad creative and status in Gemini CLI
Can Gemini CLI use Facebook Ad Library ad creative and status?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Facebook Ad Library ad creative and status like any built-in tool.
How much does Facebook Ad Library ad creative and status 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 ad creative and status in Gemini CLI?
No. Spiral runs Facebook Ad Library ad creative and status 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 ad creative and status in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Facebook Ad Library ad creative and status runs?
Facebook Ad Library ad creative and status runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.
How quickly do ad changes appear?
Meta says changes to an ad appear in the Ad Library within 24 hours. A status or creative check can therefore lag the advertiser’s latest change.
How far back does the political ad archive go?
Meta retains ads about social issues, elections, or politics for seven years. That retention period applies to those categories, rather than establishing seven years of history for every commercial ad.
Does an ad’s active status prove it performs well?
No. Public Ad Library data does not expose another advertiser’s conversions, acquisition costs, margins, or return on ad spend; spend, reach, and impression fields can also be null for ordinary commercial ads.
Why might one title miss part of an ad’s creative?
An ad can have multiple versions. ScrapeCreators specifically directs readers to the titles inside the creative cards, so inspect those before summarizing the ad.
Does this retrieve an advertiser’s entire ad collection?
This endpoint retrieves a specific ad identified by its Ad Library ID or URL. Use it to inspect known ads individually.
Start using Facebook Ad Library ad creative and status in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


