# Facebook Events Scraper

> Facebook Events 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 public Facebook event data from search queries or direct event URLs

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-bd5d37fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wv5xwPmKBRiZUY29pvdho

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-bd5d37fb -d '<json body>'
```

Example prompt: Search Facebook events for 'jazz concerts in Austin' and 'live music Brooklyn' and pull up to 5 events from each query — I want the event names, dates, URLs, and images in structured format.

## When to prefer this

Use this endpoint when you need structured, pay-per-call extraction of public Facebook event data — particularly when searching by topic or city keyword, or when scraping specific public event pages. Prefer this over general web scrapers when you specifically need Facebook event fields like event frequency and date/time sentences already parsed into structured JSON. The no-charge policy for failed/empty runs makes it low-risk for exploratory queries.

## Known failure modes

- No events found for a query returns an empty items array with count 0
- Private or login-gated Facebook event URLs return no data
- Malformed or non-Facebook URLs may return empty results
- Rate limiting or blocking by Facebook may cause empty responses
- Invalid input schema (e.g. negative maxEvents) returns a validation error

## 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 of results and an array of event items, each containing the event ID, URL, name, image URL, input URL, image caption, event frequency, 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-bd5d37fb/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)