1 page; 1 record when it falls back. A failed run costs 0. The same input within 30 min costs 0.

facebook-event

Q: How do I get Facebook data through an API?

Call POST /recipes/facebook-event with your key and event. You get rows with the 14 fields above. The recipe is tested against the live site every 6 hours.

Q: Can I try it without paying?

Yes. Sign up with Google, GitHub or email for a free key with 1,000 credits every month. No credit card.

Q: What if the site changes?

The health check runs every 6 hours against the live site. A failing recipe shows as failing on this page until we fix it.

One public Facebook event as one row: name, start and end time, the place with its map point, the host, the description, categories, whether it is online or cancelled, and the cover image. event is the event's URL or its id (the number after /events/). About 20 s; when the page fails, a slower second source answers.

stagedfacebook.comWASM module14 fields1 page; 1 record when it falls backfresh 30 min

Run it below API reference

‹ Recipes

…json

POST api.crawl4ai.com/recipes/…

$ crawl recipe

Live · your key · counts against your quota✓ 200 OK

# Hit Run - the rows render here as a table, with the cost

Fields

14 columns on every row. null means the site does not state it.

field	type	meaning
event_id	string	Facebook's id of the event (digits, as a string).
url	string	The event's page, https://www.facebook.com/events/<id>/.
name	string	The event's name.
starts_at	string	When it starts, ISO 8601 UTC.
ends_at	string	When it ends, ISO 8601 UTC; null when no end is set.
when	string	The time as Facebook writes it, with the local time zone ("Friday, August 12, 2022 at 8:00 PM – 11:00 PM EEST"); null on the second source.
place	object	Where it happens, {name, url, latitude, longitude}; null for an online event.
host	object	Who created it, {name, id}.
description	string	The event's description, plain text.
categories	string[]	Facebook's categories for it ("Party"); the second source may add the city as a tag.
responded		How many people answered the event (going or interested), as Facebook counts them.
is_online	boolean	true for an online event.
is_canceled	boolean	true when the event was cancelled.
cover	string	The cover image URL; signed by Facebook, it stops working after some days.

null means the site does not state it.

event_idstringFacebook's id of the event (digits, as a string).

urlstringThe event's page, https://www.facebook.com/events/<id>/.

namestringThe event's name.

starts_atstringWhen it starts, ISO 8601 UTC.

ends_atstringWhen it ends, ISO 8601 UTC; null when no end is set.

whenstringThe time as Facebook writes it, with the local time zone ("Friday, August 12, 2022 at 8:00 PM – 11:00 PM EEST"); null on the second source.

placeobjectWhere it happens, {name, url, latitude, longitude}; null for an online event.

hostobjectWho created it, {name, id}.

descriptionstringThe event's description, plain text.

categoriesstring[]Facebook's categories for it ("Party"); the second source may add the city as a tag.

respondedHow many people answered the event (going or interested), as Facebook counts them.

is_onlinebooleantrue for an online event.

is_canceledbooleantrue when the event was cancelled.

coverstringThe cover image URL; signed by Facebook, it stops working after some days.

How it behaves

Cost. 1 page; 1 record when it falls back. A failed run costs 0.

Freshness 30 min. The same input within 30 min is served from cache at 0 units.

How it answers. Answers at once for one input; a large run goes as a job you poll.

Questions about this recipeQuestions

Short answers. The API reference has the long ones.

How do I get Facebook data through an API?

Call POST /recipes/facebook-event with your key and event. You get rows with the 14 fields above. The recipe is tested against the live site every 6 hours.

What does it cost?

Can I try it without paying?

What if the site changes?

Need more from Facebook?

Extra fields, higher volume, or a private copy with a freshness SLA. We build it on Enterprise.

Request a change

More for local and maps

All 6 recipes →

google-maps-placesGoogle Maps

staged

The places Google Maps lists for a search, in Google's order, one row per place: name, place id and cid, category, address, map point…

Lead generation15 fields

3-4 units for 20 places; at most 42 · fresh 1 hTry it →

google-maps-reviewsGoogle Maps

staged

The reviews Google Maps shows for one place, one row per review: stars, text, date, the reviewer, likes, the owner's reply and the review's…

Market research9 fields

3-4 units; above 8: 3 + 1 per 10 · fresh 1 hTry it →

open-meteo-forecastOpen-Meteo

staged

One row per day of the daily forecast from Open-Meteo (no key): date, the weather in words and its WMO code, max and min temperature in °C…

Travel and real estate12 fields

2 units · 3 with a place name · fresh 30 minTry it →

For developers

Get a free API key and run your first crawl.

1,000 credits every month. No credit card. Your self-hosted setup keeps working.

Get a free API key

For teams

Talk to us about volume, regions and an SLA.

A 30-minute call with the team that writes the crawler. DPA on request, invoice billing, your choice of US, EU or Singapore.

Book a call hello@crawl4ai.com