# StableSocial Facebook Ad Library — Company Ads Scraper

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

Scrapes ads run by a specific company from the Facebook Ad Library, returning structured ad creative and metadata.

## Facts

- Endpoint: POST https://socialx402.com/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-46ca1fe4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uutSYXyjp3SbaafQJv6f4

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-46ca1fe4 -d '<json body>'
```

Example prompt: Pull all the current Facebook ads running for Nike from the Facebook Ad Library — I want to see the ad creatives, copy, and how long each ad has been active.

## When to prefer this

Choose this endpoint when you need to programmatically extract ads run by a specific company from the Facebook Ad Library without manual browsing. It is ideal for competitive intelligence, ad monitoring workflows, or market research where you need structured ad data at scale. Prefer this over manual Ad Library searches when you need automation, structured output, or integration into a larger data pipeline.

## Known failure modes

- Company not found in Facebook Ad Library — returns empty result or 404-equivalent
- Invalid or unrecognized company identifier — returns error
- Facebook Ad Library rate limiting or access restrictions — may return partial data
- Company has no active or archived ads — returns empty array
- Network timeout if Facebook's Ad Library is slow to respond

## How this service works

Scrape Creators · Facebook — Company Ads

## Output

Returns a structured list of ads from the Facebook Ad Library associated with the specified company, including ad creatives (images/video thumbnails), ad copy/headline text, active/inactive status, estimated impressions or spend range, ad start and end dates, 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-46ca1fe4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from socialx402.com](https://www.zero.xyz/host/socialx402.com/llms.txt)