Facebook Page Events API
List a page's upcoming or past public events with name, start time and place.
- 1 credit per call
- Failed calls are free
- Updated
- facebook.page-events.list
{ "total_items": 5, "items": [ { "name": "NASA's SpaceX Crew-13 Launch", "host_name": "NASA - National Aeronautics and Space Administration", "id": "1036015482730574", "is_canceled": false, "is_past": true, "start_at": "2026-10-01T13:20:00Z", "url": "https://www.facebook.com/events/1036015482730574/", "visibility": "public" }, { "name": "Nancy Grace Roman Space Telescope Launch", "host_name": "NASA - National Aeronautics and Space Administration", "id": "2081961559076009", "is_canceled": false, "is_past": true, "start_at": "2026-08-30T10:20:00Z", "url": "https://www.facebook.com/events/2081961559076009/", "visibility": "public" } ]}
| # | Event | Starts | Host | Past | Link | Is canceled | Visibility | Id |
|---|---|---|---|---|---|---|---|---|
| 1 | NASA's SpaceX Crew-13 Launch | 2026-10-01T13:20:00Z | NASA - National Aeronautics and Space Administration | true | https://www.facebook.com/events/1036015482730574/ | false | public | 1036015482730574 |
| 2 | Nancy Grace Roman Space Telescope Launch | 2026-08-30T10:20:00Z | NASA - National Aeronautics and Space Administration | true | https://www.facebook.com/events/2081961559076009/ | false | public | 2081961559076009 |
| 3 | Artemis II Congressional Space Medal of Honor Ceremony | 2026-08-28T15:00:00Z | NASA - National Aeronautics and Space Administration | true | https://www.facebook.com/events/1537923404197892/ | false | public | 1537923404197892 |
| 4 | 2026 Total Solar Eclipse | 2026-08-12T17:15:00Z | NASA - National Aeronautics and Space Administration | true | https://www.facebook.com/events/4632257463672182/ | false | public | 4632257463672182 |
| 5 | NASA's Artemis III Announcement | 2026-06-09T15:30:00Z | NASA - National Aeronautics and Space Administration | true | https://www.facebook.com/events/1526795995494848/ | false | public | 1526795995494848 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| url | string | yes | Public Facebook page URL; facebook.com and fb.com page links are accepted. Default: https://www.facebook.com/NASA. |
https://www.facebook.com/NASA |
| limit | integer | no | Maximum number of events to return. Facebook's public events tab carries the first batch of events (8 on the test page). From 1 to 100. Default: 20. |
5 |
| when | string | no | Upcoming or past events hosted by the page Allowed values: upcoming, past. Default: upcoming. |
past |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].name | string | The event's name. | NASA's SpaceX Crew-13 Launch |
| items[].start_at | string | When the event starts. | 2026-10-01T13:20:00Z |
| items[].host_name | string | Who hosts the event. | NASA - National Aeronautics and Space Administration |
| items[].is_past | boolean | Whether the event has already happened. | true |
| items[].is_canceled | boolean | Whether the event was cancelled. | false |
| items[].url | string | The event's page. | https://www.facebook.com/events/1036015482730574/ |
| items[].id | string | Facebook's ID for the event. | 1036015482730574 |
| items[].visibility | string | Who can see the event. | public |
| items | array | The page's events. | 5 records |
| total_items | integer | How many events this answer holds. | 5 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "facebook.page-events.list", "input": { "limit": 5, "url": "https://www.facebook.com/NASA", "when": "past" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "facebook.page-events.list", "input": { "limit": 5, "url": "https://www.facebook.com/NASA", "when": "past" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "facebook.page-events.list", "input": { "limit": 5, "url": "https://www.facebook.com/NASA", "when": "past" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Use Upscrape to list NASA's past Facebook events with their names and start times.
More from the Facebook API
- Facebook Page API1 credit
- Facebook Page Posts API1 credit
- Facebook Post API1 credit
- Facebook Post Comments API1 credit
- Facebook Comment Replies API1 credit
- Facebook Ads Library Search API1 credit
- Facebook Page Videos API1 credit
- Facebook Page Reels API1 credit
- Facebook Video API1 credit
- Facebook Reel API1 credit
- Facebook Video Transcript API1 credit
- Facebook Page About Information API1 credit
- Facebook Page Photos API1 credit
- Facebook Photo API1 credit
- Facebook Event API1 credit
- Facebook Group API1 credit
The same data from other platforms
Facebook Page Events API FAQ
The short answers. The docs have the long ones.
How much does the Facebook Page Events API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send url. The input fields below list every option with its type and limits.
Do I need a Facebook login?
No. It reads public Facebook data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds facebook.page-events.list, checks its price and runs it with the same credits as the REST API.
Your first Facebook call is free.
Up to 100 free credits to start, no card needed.