Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · Social Media

How to Use Facebook Ad Library ad creative and status in Claude Code

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 Claude Code

Copy an example into Claude Code, 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.

Facebook Ad Library ad creative and statusClaude Code
Try asking
  • 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 Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code 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.

    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 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: Claude Code 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.

ScrapeCreatorsSocial Media
Facebook Ad Library · Ad Details
scrapecreators/facebook-adlibrary-ad

Settings you can ask for

Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Trimon or off

Set to true for a trimmed down version of the response

Cache max age1d, 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 transcripton 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 Claude Code?

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.

Questions about Facebook Ad Library ad creative and status in Claude Code

Can Claude Code use Facebook Ad Library ad creative and status?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code 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 Claude Code?

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

Do I need a ScrapeCreators account to use Facebook Ad Library ad creative and status in Claude Code?

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 Claude Code?

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

Does Claude Code wait while Facebook Ad Library ad creative and status runs?

Facebook Ad Library ad creative and status runs in the background. Claude Code 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.

Get started

Start using Facebook Ad Library ad creative and status in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options