# Search events (v1)

Searches public Facebook events by free text and returns each event's id, name, URL and cover image. Dates and venues are not shown without an account. Paginate with `cursor` from `pageInfo`. An empty `events` array means no public match.

- Platform: Facebook
- Request: `GET https://api.toolzerhub.com/v1/facebook/search/events`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/facebook/search/search-facebook-events

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `query` | query | yes | string | Free-text search phrase. |
| `cursor` | query | no | string | Opaque pagination cursor from a previous response. |
| `count` | query | no | integer | Records per page. Facebook caps most surfaces well below this. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/facebook/search/events?query=<query>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.