# Facebook Public Page Search Scraper

> Facebook Public Page Search Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Searches and returns structured data about public Facebook Pages matching given keywords and optional location filters

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/facebook-search?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/facebook-public-page-search-scraper-a576654c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fwje4t6RcBnsI4peO10KE

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 facebook-public-page-search-scraper-a576654c -d '<json body>'
```

Example prompt: Search Facebook for public pages in the 'coffee shop' and 'cafe' categories located in Seattle and Portland, returning up to 30 results across 3 search pages.

## When to prefer this

Use this endpoint when you need structured, pay-per-result data about public Facebook Pages discovered by keyword and location — particularly for lead generation, competitor research, or brand discovery workflows. Prefer this over manual browsing or generic web scrapers when you need clean, deduplicated Facebook-specific page metadata at scale without paying for failed or empty runs.

## Known failure modes

- No matching pages found — returns empty items array (not charged)
- Facebook blocks or rate-limits the scraper — may return partial or empty results
- Invalid or unsupported keyword/location combinations returning zero results
- Network timeout causing failed run (not charged)
- resultsLimit or maxSearchPages out of allowed range returns a validation error

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of public Facebook Page records, each containing the page title, page ID, page URL, page name, categories, Facebook ID, and Facebook URL. Fields may be null if not available for a given page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "locations": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "default": [],
   "description": "Optional city, region, or country text added to each search term. An empty list searches without a location."
  },
  "categories": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Keywords used to find public Facebook Pages. Each term is searched with each location."
  },
  "resultsLimit": {
   "type": "integer",
   "default": 50,
   "minimum": 1,
   "description": "Maximum number of distinct public Page results in the whole dataset."
  },
  "maxSearchPages": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "Maximum public search result pages to inspect for each keyword and location pair."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "info": null,
    "title": null,
    "pageId": null,
    "pageUrl": null,
    "pageName": null,
    "categories": null,
    "facebookId": null,
    "facebookUrl": null
   }
  ],
  "product": "facebook-search"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/facebook-public-page-search-scraper-a576654c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)
