# StableSocial Facebook Ad Library — Company Ads Scraper

> StableSocial Facebook Ad Library — Company Ads Scraper is a paid API for AI agents from stablesocial.dev, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Scrapes and returns ads run by a specific company from the Facebook Ad Library

## Facts

- Endpoint: POST https://stablesocial.dev/api/sc/facebook/adLibrary/company/ads
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablesocial-facebook-ad-library-company-ads-scraper-42596c28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x2Z6Q-Oqm96fI9xFkBY9W

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablesocial-facebook-ad-library-company-ads-scraper-42596c28 -d '<json body>'
```

Example prompt: Pull all the current Facebook ads from Nike's company page using the Facebook Ad Library so I can see what campaigns they're actively running.

## When to prefer this

Use this endpoint when you need structured ad data for a specific company from Facebook's Ad Library, particularly for competitive intelligence, ad creative research, or campaign monitoring. It is preferable to manual browsing of the Facebook Ad Library UI and useful for agents that need programmatic access to Facebook advertising data at scale. Choose this over general web scraping tools when you specifically need Facebook company ad data in a structured format.

## Known failure modes

- Company not found in Facebook Ad Library — returns empty results or error
- Invalid company name or page ID — may return unrelated ads or no results
- Rate limiting or access restrictions from Facebook's Ad Library API
- Ads data may be incomplete for political or issue-based ad categories
- Endpoint may return stale cached data if the ad library hasn't been recently indexed

## How this service works

Scrape Creators · Facebook — Company Ads

## Output

Returns a list of ads associated with the specified company from the Facebook Ad Library, including ad creatives, copy, active/inactive status, estimated spend ranges, impressions data, date ranges the ads ran, and targeting details where available.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "trim": {
   "type": "boolean",
   "description": "Set to true for a trimmed down version of the response"
  },
  "cursor": {
   "type": "string",
   "description": "Cursor to paginate through results"
  },
  "pageId": {
   "type": "string",
   "description": "The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName"
  },
  "status": {
   "enum": [
    "ALL",
    "ACTIVE",
    "INACTIVE"
   ],
   "type": "string",
   "description": "Status of the ad. Defaults to ACTIVE."
  },
  "country": {
   "type": "string",
   "description": "This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL."
  },
  "sort_by": {
   "enum": [
    "total_impressions",
    "relevancy_monthly_grouped"
   ],
   "type": "string",
   "description": "Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions."
  },
  "end_date": {
   "type": "string",
   "description": "End date to search for. Format: YYYY-MM-DD"
  },
  "language": {
   "type": "string",
   "description": "Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc"
  },
  "media_type": {
   "enum": [
    "ALL",
    "IMAGE",
    "VIDEO",
    "MEME",
    "IMAGE_AND_MEME",
    "NONE"
   ],
   "type": "string",
   "description": "Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme."
  },
  "start_date": {
   "type": "string",
   "description": "Start date to search for. Format: YYYY-MM-DD"
  },
  "companyName": {
   "type": "string",
   "description": "The name of the company. Can either use this or pageId"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-facebook-ad-library-company-ads-scraper-42596c28/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)