Facebook Ads Library

from $0.002250 per resultfacebook.ads

Ads from the public Facebook Ads Library for a page or a keyword search, with creative body, headline, call to action, landing URL, run dates, platforms and page metadata.

What a call costs

Billed on actual usage, minimum $0.0020 per call, capped at $6.00 per call.

a price before every call. failed calls are never charged.

When to use it

Use for competitor ad research: what a brand is running right now, which hooks and landing pages it uses, and how long each ad has been live. Note the billing model, count is the maximum CHARGED results and the actor bills the full count even when fewer ads exist.

Inputs

Facebook Ads Library takes 9 fields, 1 of them required. Anything you leave out falls back to the tool's own default.

Field	Type	Required	What it does
urls	array of object	yes	Facebook page URLs, or Ads Library search URLs such as https://www.facebook.com/ads/library/?q=nike&country=US, one object per source.
count	integer	optional	Maximum CHARGED results. The actor refuses to run below 10 and bills this full number even when fewer ads are found, verified live 2026-07-30 (count 10 returned 3 ads and billed 10). Set it to what you are willing to pay for.
runTag	string	optional	Free-form label copied into a runTag column on every output row.
limitPerSource	integer	optional	Maximum ads per input URL. The actual number can exceed this by up to 30. Use count to bound the bill.
scrapeAdDetails	boolean	optional	Also fetch ad detail data such as EU reach info. No extra charge event, but it makes runs slower.
scrapePageAds.period	string	optional	Date range filter applied when scraping ads from page URLs.
scrapePageAds.sortBy	string	optional	Sort page ads by impressions or recency.
scrapePageAds.countryCode	string	optional	Uppercase ISO 3166-1 alpha-2 country code, or ALL.
scrapePageAds.activeStatus	string	optional	Filter page ads by active status.

How to call it

Connect once and your agent can reach Facebook Ads Library the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.

MCP

Add this server in Claude, Claude Code, or any MCP client.

https://mcp.usegoro.ai/mcp

Skill

One line in your agent's chat. It sets itself up.

set up https://usegoro.ai/SKILL.md

Or plain HTTP

POST /v1/run

{
  "endpoint": "facebook.ads",
  "input": {
    "urls": [
      "<urls>"
    ],
    "scrapePageAds.period": "",
    "scrapePageAds.sortBy": "impressions_desc",
    "scrapePageAds.countryCode": "ALL",
    "scrapePageAds.activeStatus": "all"
  }
}

Related tools

More from social platforms, or browse the full tool catalog.

Facebook events

Structured Facebook event records: name, description, start time and duration, going, interested and responded counts, venue with address,...

from $0.03 per event

Facebook group posts

Posts from public Facebook groups with post text, author, permalink, timestamp, attachments and reaction, comment and share counts.

from $0.0120 per post

Facebook page profile

Public profile data for Facebook pages: title, category, likes and follower counts, intro text, contact email, website, creation date, ad status and...

from $0.0246 per result

Facebook page reviews

Recommendations and reviews left on a public Facebook page, with review text, reviewer, date, recommended or not, attribute tags and engagement...

from $0.0060 per review

Further reading: Social listening with AI agents: track mentions, trends and competitors

Run Facebook Ads Library from your agent.

One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.

Get started