100 free credits. No credit card required.Start building
Logo
Facebook logo
100 free credits. No credit card required

Facebook Event Details API

Returns one Facebook event in full: title, description, start and end time, location, host, cover image, and RSVP counts when shown.

GET /v1/facebook/event/details

Last updated November 2026Maintained by the SocialCrawl team

When to use the Facebook Event Details API

Use it after events, events/search, or profile/events when a listing row is not enough, by event id or URL.

From the API reference

Fetches full metadata for a Facebook event. The canonical Post leaves carry the title (content.text), the cover image (content.thumbnail_url), the permalink and the host line; the event record itself rides post.ext.event: description, start_timestamp and end_timestamp, the rendered time_text ("Saturday, August 29, 2026 at 7:00 PM - 9:00 PM PDT", the only place the event's own timezone appears), duration_text, location_name, address, city, latitude and longitude, hosts[] (each with id, name, url and a verification flag), category, ticket_url, privacy, is_online, is_canceled, is_past, and the RSVP counts interested_count, going_count and attendance_count. **Read the RSVP counts from post.ext.event, not from post.engagement:** an event has no views or likes, so engagement.views carries the interested count and engagement.likes the going count for archetype compatibility, and computed.engagement_rate is derived from those RSVPs rather than from any real engagement.

Searching 75 platforms in parallel

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
Facebook API

What can you do with the Event Details API?

The Event Details endpoint gives you structured Facebook data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

# GET /v1/facebook/event/details: 1 credit per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://www.socialcrawl.dev/v1/facebook/event/details?url=https%3A%2F%2Fwww.facebook.com%2Fevents%2F4271394179613905%2F" && cat response.json
# GET /v1/facebook/event/details: 1 credit per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid

import requests

API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60  # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/facebook/event/details"


def backoff(attempt):
    # Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
    return 2 ** attempt * (0.5 + random.random() / 2)


def socialcrawl(params):
    # One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
    idempotency_key = str(uuid.uuid4())
    for attempt in range(MAX_RETRIES + 1):
        try:
            res = requests.get(
                URL,
                params=params,
                headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
                timeout=TIMEOUT_S,
            )
            body = res.json()
        except (requests.RequestException, ValueError):
            # A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
            if attempt == MAX_RETRIES:
                raise
            time.sleep(backoff(attempt))
            continue
        if body["success"]:
            return body
        error = body["error"]
        # Branch on error["type"], never on the message text.
        if error["type"] == "RESOURCE_NOT_FOUND":
            return None  # refunded: nothing to read
        retry_after = res.headers.get("Retry-After")
        # SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
        permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
        if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
            raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
        # Retry-After (seconds) wins; otherwise back off.
        time.sleep(float(retry_after) if retry_after else backoff(attempt))


params = {
    "url": "https://www.facebook.com/events/4271394179613905/",
}
body = socialcrawl(params)
if body is not None:
    print(body["data"])
// GET /v1/facebook/event/details: 1 credit per call. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;

type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
  | { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
  | { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };

const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);

async function socialcrawl(url: URL) {
  // One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
  const idempotencyKey = crypto.randomUUID();
  for (let attempt = 0; ; attempt++) {
    let res: Response;
    let body: SocialCrawlResponse;
    try {
      res = await fetch(url, {
        headers: {
          "x-api-key": API_KEY,
          "Idempotency-Key": idempotencyKey,
        },
        signal: AbortSignal.timeout(TIMEOUT_MS),
      });
      body = (await res.json()) as SocialCrawlResponse;
    } catch (error) {
      // A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
      if (attempt >= MAX_RETRIES) throw error;
      await sleep(backoffMs(attempt));
      continue;
    }
    if (body.success) return body;
    // Branch on error.type, never on the message text.
    if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
    const retryAfter = res.headers.get("Retry-After");
    // SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
    const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
    if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
      throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
    }
    // Retry-After (seconds) wins; otherwise back off.
    await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
  }
}

const url = new URL("https://www.socialcrawl.dev/v1/facebook/event/details");
url.searchParams.set("url", "https://www.facebook.com/events/4271394179613905/");

const body = await socialcrawl(url);
if (body) console.log(body.data);

Parameters

ParameterRequiredDescription
idNoFacebook event ID (numeric).
urlNoFull URL of the event.
Example Response

What does the Facebook Event Details API return?

Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.

Example response
{
  "success": true,
  "platform": "facebook",
  "endpoint": "/v1/facebook/event/details",
  "data": {
    "post": {
      "id": "4271394179613905",
      "url": "https://www.facebook.com/events/4271394179613905/",
      "content": {
        "text": "Freiburger Wissenschaftsmarkt",
        "media_urls": null,
        "thumbnail_url": "https://scontent-iad6-1.xx.fbcdn.net/v/t1.6435-9/201672358_4103137223114460_269628764596134091_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=75d36f&_nc_ohc=IxI4v7HInakQ7kNvwE4Ol-c&_nc_oc=AdrLRXHbGca14HlUeTaBSQF_sn-c9ii1g1CRwPVaAafKj-HT6ZXkwVq8TPzcX-IVXlE&_nc_zt=23&_nc_ht=scontent-iad6-1.xx&_nc_gid=2-MgCNFJmn0ZKoe0gxFY9g&_nc_ss=78180&oh=00_AQQJTGH4uTIqdKnTn7CVHUV7p77jx5mWzx8QE-AXECRpsg&oe=6B0F5114",
        "duration_seconds": null
      },
      "author": {
        "username": null,
        "display_name": "Event by Albert-Ludwigs-Universität Freiburg",
        "avatar_url": null,
        "verified": null
      },
      "engagement": {
        "views": 11,
        "likes": 2,
        "comments": null,
        "shares": null,
        "saves": null
      },
      "flags": {
        "nsfw": null,
        "spoiler": null,
        "pinned": null,
        "deleted": false
      },
      "published_at": "2021-06-18T08:00:00.000Z",
      "ext": {
        "published_at_epoch": 1624003200,
        "hashtags": null,
        "mentions": null,
        "event": {
          "description": "Welche Signalwege nutzen Körperzellen, um miteinander zu kommunizieren? Wie ist eine nachhaltige Energieversorgung möglich? Was kann die personalisierte Medizin leisten? Wie können sich Materialien selbstständig an ihre Umwelt anpassen? Und welche Chancen und Risiken sind mit dem Einsatz künstlicher Intelligenz verbunden? Der digitale „Freiburger Wissenschaftsmarkt“ (7.-26. Juni 2021) zeigt mit anschaulichen und interaktiven Angeboten, was die Forschung in der Region zu bedeutenden gesellschaftlichen Fragen und Herausforderungen beiträgt.",
          "start_timestamp": 1624003200,
          "end_timestamp": null,
          "time_text": "Jun 18, 2021 at 10:00 AM – Jun 27, 2021 at 10:00 AM CEST",
          "duration_text": "9 days",
          "location_name": "Online event",
          "address": null,
          "city": null,
          "latitude": null,
          "longitude": null,
          "hosts": [
            {
              "id": "99000011027961",
              "name": "user_c5135f",
              "type": "User",
              "url": "https://example.com/user_422651",
              "is_verified": false,
              "profile_picture_url": "https://example.com/avatars/user_2809a3.png"
            }
          ],
          "host_context_text": "Event by Albert-Ludwigs-Universität Freiburg",
          "category": "Home & garden",
          "is_online": true,
          "is_canceled": false,
          "is_past": true,
          "privacy": "public",
          "ticket_url": null,
          "attendance_count": 13,
          "interested_count": 11,
          "going_count": 2
        }
      }
    },
    "computed": {
      "engagement_rate": 0.181818,
      "language": null,
      "content_category": "other",
      "estimated_reach": 13
    }
  },
  "credits_used": 1,
  "request_id": "req_example000000",
  "cached": false,
  "credits_remaining": 9999,
  "source": "captured",
  "captured_at": "2026-11-02T01:04:39.113Z",
  "redacted": true
}

Live sample illustrating the unified response shape. Field values reflect the record you query.

API Details

How does the Facebook Event Details API work?

Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for Facebook Event Details data?

We handle the complexity of Facebook data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 75 platforms covering 10B+ monthly active users.

One schema, every platform

Query 75 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.

See your data before you code

Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 75 platforms
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What is the Facebook event API?
GET /v1/facebook/event/details returns the full details for one Facebook event. Anchor the call with the event id or its url and you get the date, venue, description, ticket info, and going count as JSON. It costs 1 credit.
Do I pass an id or a url?
Either one. The endpoint accepts id or url and you supply exactly one. Pass id if you captured it from an events list or search; pass url if you only have the event's shared link.
What fields come back for an event?
You get the event name, description, start and end date, venue and location, host, cover image, ticket or registration info, and attendance counts like interested and going. Fields follow the shared SocialCrawl schema.
How does this pair with the events list?
Reach for it when you already have one event id in hand, or when you came from /v1/facebook/events/search. If you are working through a listing, /v1/facebook/events and /v1/facebook/profile/events both take include=details and fill the deep fields on every row in the same call, so there is no need for a lookup per event.
How much does it cost?
Each event detail lookup is 1 credit on the standard tier. New accounts get 100 free credits with no card, so you can inspect the full response shape before you build.

Ask AI about SocialCrawl

Ready to scrape Facebook Event Details data?

Get your API key and start pulling Facebook data in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown