# Facebook Events Scraper (x402)

> Facebook Events 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 structured Facebook event data from public event detail URLs or search queries, returning event names, dates, images, and URLs per result.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/facebook-events?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-events-scraper-x402-7dc20809
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x0zJqi8Ek1D_Kqvjo3cjI

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-events-scraper-x402-7dc20809 -d '<json body>'
```

Example prompt: Search Facebook Events for 'jazz concerts in Chicago' and pull up to 10 events — I want the event names, dates, URLs, and any images.

## When to prefer this

Use this endpoint when you need structured event data from Facebook's public events pages without managing your own scraper or browser automation. It's ideal for discovering local or topical events via search queries or extracting details from known event page URLs, and the pay-only-on-success model makes it cost-efficient for exploratory queries.

## Known failure modes

- Facebook changes its public HTML structure, causing empty results
- Private or login-gated events return no data
- Search queries with no results return an empty items array (not charged)
- Rate limiting or IP blocking by Facebook may cause failures
- Invalid or malformed URLs cause empty or error responses

## 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 and an array of event items, each containing the event's ID, URL, name, image URL, input URL, image caption, event frequency description, and a human-readable date/time sentence. Empty or failed runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Maximum output records across all sources. Zero means no total cap."
  },
  "maxEvents": {
   "type": "integer",
   "default": 7,
   "minimum": 1,
   "description": "Maximum events from each query or URL. Public search pages currently expose around seven initial results."
  },
  "startUrls": {
   "type": "array",
   "default": [],
   "description": "Public event detail URLs or event search URLs. Search pages use the first visible result page."
  },
  "searchQueries": {
   "type": "array",
   "default": [],
   "description": "Topics, cities, or combinations used to find public events. Each query yields the first public search page."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "name": null,
    "imageUrl": null,
    "inputUrl": null,
    "imageCaption": null,
    "eventFrequency": null,
    "dateTimeSentence": null
   }
  ],
  "product": "facebook-events"
 }
}
```

## More

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