# Facebook Public Page Search API (x402)

> Facebook Public Page Search API (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Searches Facebook public Pages by keyword categories and optional locations, returning structured page metadata as pay-per-call scraped data.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-api-x402-f54317d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FJEBcuLd0h7djvMrH99Pc

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-api-x402-f54317d4 -d '<json body>'
```

Example prompt: Search Facebook for public pages about 'yoga studios' and 'wellness centers' in Austin and Denver — give me up to 30 results and check up to 5 search pages per keyword.

## When to prefer this

Use this endpoint when you need structured data about public Facebook Pages discovered by keyword and optional geographic filter — especially for lead generation, competitor research, or local business discovery. Prefer this over manual Facebook search when you need programmatic, structured output at scale. Best suited for agents needing page-level metadata (URL, ID, name, categories) rather than post-level content or user profile data.

## Known failure modes

- Empty result set if no matching Facebook pages are found for the given keywords and locations (not charged)
- Rate limiting or blocking by Facebook scraping infrastructure
- Invalid or overly broad search categories returning irrelevant pages
- maxSearchPages cap (10) limits depth of results for highly competitive terms
- Network or upstream scraping failure returning an error (not charged)

## How this service works

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

## Output

A JSON object containing a count of results and an array of Facebook Page items, each with fields including title, pageId, pageUrl, pageName, categories, facebookId, and facebookUrl. Only successful, non-empty runs are charged.

## 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-api-x402-f54317d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)