# Facebook Reviews Scraper

> Facebook Reviews 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).

Scrapes and returns structured review data from public Facebook business pages

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/facebook-reviews?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-reviews-scraper-13742ae5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AKgHVvSG7AxmRCpCm0vAZ

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-reviews-scraper-13742ae5 -d '<json body>'
```

Example prompt: Pull up to 200 Facebook reviews for my restaurant's page at facebook.com/MyRestaurantPage/reviews, but only include reviews posted after 2025-01-01.

## When to prefer this

Choose this endpoint when you need structured, paginated Facebook review data from one or more public business pages, especially when you want to filter by recency or cap the number of results. It is pay-per-call and does not charge for failed or empty runs, making it cost-effective for exploratory or monitoring workflows.

## Known failure modes

- Private or restricted Facebook pages return no results
- Invalid or malformed page URLs result in empty item arrays
- Rate limiting or scraping blocks from Facebook may yield partial results
- Date filter syntax errors may cause unexpected results or errors
- Pages with zero reviews return an empty items array (not charged)

## How this service works

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

## Output

Returns a JSON object containing a count of reviews and an array of review items, each with fields including review ID, review URL, review date, input URL, page name, Facebook ID, Facebook URL, and legacy ID. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "startUrls": {
   "type": "array",
   "description": "Public page URLs, preferably ending in /reviews."
  },
  "resultsLimit": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum number of reviews across all supplied pages. Set 0 to collect all accessible results."
  },
  "onlyReviewsNewerThan": {
   "type": "string",
   "description": "Optional UTC cutoff date, such as 2025-01-01, or a relative period such as 3 months."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "date": null,
    "inputUrl": null,
    "legacyId": null,
    "pageName": null,
    "facebookId": null,
    "facebookUrl": null
   }
  ],
  "product": "facebook-reviews"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/facebook-reviews-scraper-13742ae5/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)