# Facebook Reviews Scraper (x402)

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

Scrapes and returns structured review data from public Facebook business pages, with optional date filtering and result limits, billed per successful call.

## Facts

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

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-x402-76d49297 -d '<json body>'
```

Example prompt: Can you pull up to 200 Facebook reviews from https://www.facebook.com/acmecoffee/reviews that were posted after January 1, 2025?

## 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 date-filtered results or a capped number of reviews. It is cost-efficient because failed or empty runs are not charged. Prefer it over general web scraping endpoints when you specifically need Facebook review fields like page name, Facebook ID, and legacy ID in a normalized format.

## Known failure modes

- Private or restricted Facebook pages return empty results (not charged)
- Invalid or non-review URLs may return zero items
- Rate limits or Facebook anti-scraping measures may cause empty runs (not charged)
- Malformed date strings in onlyReviewsNewerThan may be rejected or ignored
- resultsLimit of 0 may trigger very long collection times for pages with thousands of reviews

## 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 matched reviews and an items array, where each item includes the review's ID, URL, date, input URL, legacy ID, page name, Facebook ID, and Facebook URL. Only successful, non-empty runs are 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-x402-76d49297/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)