Event Details

GET /v1/facebook/event/details

Get a specific event by its URL or id

Authentication

All requests require the x-api-key header. Get your key at scrapecreators.com.

Query Parameters

Name	Type	Required	Description	Example
id	string	no	The ID of the event	2255360061870188
url	string	no	The URL of the event	https://www.facebook.com/events/2255360061870188/

Example Request

curl

curl 'https://api.scrapecreators.com/v1/facebook/event/details' \
  -H 'x-api-key: $SCRAPECREATORS_API_KEY'

Node / TypeScript

const params = new URLSearchParams({  });
const res = await fetch(`https://api.scrapecreators.com/v1/facebook/event/details?${params}`, {
  headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);

Python

import os, requests
r = requests.get(
    'https://api.scrapecreators.com/v1/facebook/event/details',
    headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
    params={},
)
r.raise_for_status()
print(r.json())

CLI

scrapecreators facebook-events event-details --help

Example Response

{
  "success": true,
  "credits_remaining": 49998229823,
  "id": "2255360061870188",
  "url": "https://www.facebook.com/events/2255360061870188/",
  "name": "May St. Pete Flea ",
  "description": "SPRING IS HERE AND WE CAN’T WAIT TO SEE YOU AT THE MARKET! \nMeet us downtown at Mirror Lalke as we host some of the best makers, artists and small businesses in the Tampa Bay area. \n\nWe have three great dates this spring to shop with us as we bring you best Tampa Bay has to offer in locally made and curated hand-crafted goods, vintage housewares, decor, Mid-century furniture, vintage clothing, antiques, plants, collectables, food, music, art and so much more.  \n\nSunday, March 8th, 2026\nSunday, April 12th, 2026\nSunday, May 3rd, 2026\n********\n12:00 p.m. - 4:00 p.m.�Free to the Public * Family Friendly *\n\n* LOCATION *\nThe market will be held out in Downtown St. Petersburg, in front of our beautiful City Hall and Courthouse, right next to Mirror Lake.",
  "category": null,
  "categories": [],
  "is_online": false,
  "is_past": true,
  "event_kind": "PUBLIC_TYPE",
  "privacy": "public",
  "start_time": null,
  "end_time": null,
  "time_text": null,
  "duration": "4 hr",
  "price": null,
  "ticket_url": null,
  "ticket_source": null,
  "ticket_provider": null,
  "location_name": "Mirror Lake Park, Downtown St Pete",
  "address": "Saint Petersburg, FL",
  "city": "Saint Petersburg, Florida",
  "city_id": "111326725552547",
  "latitude": 27.776053761243,
  "longitude": -82.639546684316,
  "attendance_count": 7654,
  "attendance_facepile_count": 0,
  "can_view_members": true,
  "host_context_text": "Event by The Indie Flea",
  "hosts": [
    {
      "id": "100082008263628",
      "name": "The Indie Flea",
      "type": "User",
      "url": "https://www.facebook.com/theindieflea",
      "is_verified": false,
      "profile_picture_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.30808-1/464183650_549071584503112_3055385531133902634_n.jpg?stp=cp0_dst-jpg_s74x74_tt6&_nc_cat=104&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=5rQ_jTw3GmkQ7kNvwG062e2&_nc_oc=Adr0ZXLJg--_9LY1GPBvQABFqOzL6wTn_aMOdCu9Zr2BLpmWroH4DZsu0X8vbozAD3E&_nc_zt=24&_nc_ht=scontent-lga3-3.xx&_nc_gid=WDxpm-eBdx7_ruGu2J3r9g&_nc_ss=7e289&oh=00_Af56igLhRkYx3GHjB0h01m3pF--mGdMzoxFg0euvJmK5DA&oe=69FEB26B"
    }
  ],
  "host_names": [
    "The Indie Flea"
  ],
  "creator": {
    "id": "100082008263628",
    "name": "The Indie Flea",
    "type": "User",
    "url": null,
    "is_verified": null,
    "profile_picture_url": null
  },
  "description_links": [],
  "can_viewer_message": false,
  "is_viewer_host": false,
  "is_canceled": false,
  "cover_photo_url": "https://scontent.fbra1-1.fna.fbcdn.net/v/t39.30808-6/651106377_950305721046361_5055393414866459656_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=7e0d18&_nc_ohc=uoUS18WdA8AQ7kNvwFUcvhb&_nc_oc=AdqWorZuBJd3sf4yoI3PeFWcGVbKk8NCCM5lLn8K1d2x_sWSVx3EPXl8AEd0DXCsij8&_nc_zt=23&_nc_ht=scontent.fbra1-1.fna&_nc_gid=DdGE8ikSxarHGscPQzyAkw&_nc_ss=7e289&oh=00_Af6T6mHBTX5yD6aHFEpp4NG
... (truncated)

Credits

Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.

Errors

Status	Meaning	Action
200	Success.	Use the JSON payload.
400	Invalid or missing parameter.	Verify required parameters and value format.
401	Missing or invalid x-api-key.	Pass a valid API key in the header.
402	Out of credits.	Top up at scrapecreators.com or wait for plan reset.
404	Resource not found or private.	Confirm the handle, URL, or id and that the resource is public.
429	Rate limited.	Backoff and retry with exponential delay.
500	Server error or upstream platform failure.	Retry with backoff; report persistent errors to support.