# Facebook Search Scraper (Apify via StableApify)

> Facebook Search Scraper (Apify via StableApify) is a paid API for AI agents from stableapify.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Starts an Apify actor run that scrapes Facebook search results, returning page URLs, addresses, emails, websites, check-ins, creation dates, ad status, categories, and follower counts for pages matching a search query.

## Facts

- Endpoint: POST https://stableapify.dev/api/actors/apify/facebook-search-scraper/call
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/facebook-search-scraper-apify-via-stableapify-b4e5e255
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cZzEOTGoNrx4koingbwrr

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-search-scraper-apify-via-stableapify-b4e5e255 -d '<json body>'
```

Example prompt: Search Facebook for 'pizza restaurants in Chicago' and scrape up to 50 matching pages — I need each page's URL, email, phone, website, and category.

## When to prefer this

Choose this endpoint when you need structured data from Facebook search results at scale — especially business page metadata like emails, addresses, and follower counts — without managing Apify credentials yourself. It is ideal for lead generation, competitive research, or local business mapping workflows where Facebook is the target platform. Prefer this over generic web scrapers when Facebook-specific fields (check-ins, ad status, page category) are needed.

## Known failure modes

- Facebook anti-scraping measures may block requests or return incomplete results
- Run starts asynchronously — data is not immediately available; must poll dataset endpoint
- Invalid or overly broad search queries may return zero results
- Memory allocation too low may cause actor to fail mid-run
- Rate limits on Apify platform may delay or reject runs
- Payment failure via x402 if insufficient USDC balance
- Token expiry (30-day TTL) before dataset is fetched

## How this service works

Start the "Facebook Search Scraper" Apify actor (apify/facebook-search-scraper). Extract Facebook search data from pages that match your search query. Get page URL, address, email, website, check-ins, creation date, ad status, category, fol…

## Output

Returns an actor run object containing a run ID, status (READY), actor ID, start timestamp, total usage in USD, default dataset ID, and a JWT access token. The token and dataset ID can be used with a companion endpoint to fetch the actual scraped Facebook page records once the run completes.

## Example request

```json
{
 "input": {
  "bbox": {
   "east": -73.9352,
   "west": -74.006,
   "north": 40.758,
   "south": 40.7128
  },
  "sort": "globalrelevanceex",
  "maxItems": 50,
  "listingType": "for_sale",
  "extractionMethod": "MAP_MARKERS"
 },
 "options": {
  "memory": 2048,
  "maxItems": 50
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "categories",
    "locations"
   ],
   "properties": {
    "locations": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "default": [],
     "description": "Free text location definition. Just add a name of a country, city or province."
    },
    "categories": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "default": [],
     "description": "Add one or multiple keywords. You can add the keywords one by one, or use the Bulk edit section to pull them from a prepared list."
    },
    "resultsLimit": {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": 1,
     "description": "Set the number of results you expect for the entire run. ⚠️ The max limit for Facebook search results is set to 1,000 to keep scraping efficient. More details in the README ."
    }
   },
   "description": "Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).",
   "additionalProperties": {}
  },
  "options": {
   "type": "object",
   "properties": {
    "build": {
     "type": "string",
     "maxLength": 100,
     "minLength": 1
    },
    "memory": {
     "type": "integer",
     "maximum": 32768,
     "minimum": 128
    },
    "maxItems": {
     "type": "integer",
     "maximum": 100000,
     "minimum": 1
    }
   },
   "description": "Optional Apify run options.",
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/facebook-search-scraper-apify-via-stableapify-b4e5e255/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableapify.dev](https://www.zero.xyz/host/stableapify.dev/llms.txt)