Get a Facebook event

Try in Playground

Retrieve a public event with schedule, venue, description, hosts, tickets and attendance fields where exposed. A recurring event resolves to its current occurrence.

GET/v1/facebook/event/detailsx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

idstringquery

Numeric public resource identifier.

Example500000000000001

urlstringquery

Public HTTPS Facebook resource URL. Common tracking parameters are stripped; credentials, ports, lookalike hosts, traversal and unsupported paths are rejected.

max 4096 chars

Response fields

idstring

Numeric public resource identifier.

series_idstringnullable

ID of the recurring series when the event recurs; otherwise null.

occurrence_idstringnullable

ID of the occurrence that was read when the event recurs; otherwise null. A series ID resolves to its current occurrence.

urlstring

Public HTTPS Facebook resource URL. Common tracking parameters are stripped; credentials, ports, lookalike hosts, traversal and unsupported paths are rejected.

namestring

Public source name; null or empty when no value is exposed.

descriptionstringnullable

Public source description; null or empty when no value is exposed.

categorystringnullable

Public source category; null or empty when no value is exposed.

categoriesstring[]

Public source categories; null or empty when no value is exposed.

is_onlinebooleannullable

Public source is_online; null or empty when no value is exposed.

is_pastbooleannullable

Public source is_past; null or empty when no value is exposed.

event_kindstringnullable

Public source event_kind; null or empty when no value is exposed.

privacystringnullable

Public source privacy; null or empty when no value is exposed.

start_timestringnullable

Public source start_time; null or empty when no value is exposed.

end_timestringnullable

Public source end_time; null or empty when no value is exposed.

time_textstringnullable

Public source time_text; null or empty when no value is exposed.

durationstringnullable

Public source duration; null or empty when no value is exposed.

pricestringnullable

Public source price; null or empty when no value is exposed.

ticket_urlstringnullable

Public source ticket_url; null or empty when no value is exposed.

ticket_sourcestringnullable

Public source ticket_source; null or empty when no value is exposed.

ticket_providerstringnullable

Public source ticket_provider; null or empty when no value is exposed.

location_namestringnullable

Public source location_name; null or empty when no value is exposed.

addressstringnullable

Public source address; null or empty when no value is exposed.

citystringnullable

Public source city; null or empty when no value is exposed.

city_idstringnullable

Public source city_id; null or empty when no value is exposed.

latitudenumbernullable

Public source latitude; null or empty when no value is exposed.

longitudenumbernullable

Public source longitude; null or empty when no value is exposed.

attendance_countnumbernullable

Public source attendance_count; null or empty when no value is exposed.

attendance_facepile_countnumbernullable

Public source attendance_facepile_count; null or empty when no value is exposed.

can_view_membersbooleannullable

Public source can_view_members; null or empty when no value is exposed.

host_context_textstringnullable

Public source host_context_text; null or empty when no value is exposed.

hostsobject[]

Public source hosts; null or empty when no value is exposed.

up to 100 items

host_namesstring | null[]

Public source host_names; null or empty when no value is exposed.

creatorobjectnullable

Public source creator; null or empty when no value is exposed.

description_linksstring[]

Public source description_links; null or empty when no value is exposed.

can_viewer_messagebooleannullable

Public source can_viewer_message; null or empty when no value is exposed.

is_viewer_hostbooleannullable

Public source is_viewer_host; null or empty when no value is exposed.

is_canceledbooleannullable

Public source is_canceled; null or empty when no value is exposed.

cover_photo_urlstringnullable

Public source cover_photo_url; null or empty when no value is exposed.

day_time_sentencestringnullable

Public source day_time_sentence; null or empty when no value is exposed.

rsvp_stylestringnullable

Public source rsvp_style; null or empty when no value is exposed.

event_placeobjectnullable

Public source event_place; null or empty when no value is exposed.

price_infoJSONnullableoptional

Public source price_info; null or empty when no value is exposed.

current_start_timestampnumbernullable

Public source current_start_timestamp; null or empty when no value is exposed.

start_timestampnumbernullable

Public source start_timestamp; null or empty when no value is exposed.

start_time_formattedstringnullable

Public source start_time_formatted; null or empty when no value is exposed.

interested_countnumbernullable

Public source interested_count; null or empty when no value is exposed.

going_countnumbernullable

Public source going_count; null or empty when no value is exposed.

dataobjectoptional

Normalized result with author, post, event or listing data and per-item coverage where applicable.

When include is requested: total rows, successfully enriched rows and failed rows.

hydration.totalinteger

Always included.

hydration.enrichedinteger

Always included.

hydration.failedinteger

Always included.

successboolean

True when usable public data is returned.

statusenum

success or partial on HTTP 200; failed or challenged on failure.

one of: success, partial

requestIdstring

Request correlation UUID.

sourceUrlstring

Canonical public Facebook page used for retrieval.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Completeness of this bounded response. Warnings name restricted, missing, interrupted or unavailable optional data.

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

Counted upstream requests, decoded response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsinteger

Always included.

≥ 0

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with explicit missing/failed auxiliary coverage.
400	`invalid_request`	Malformed, duplicate, conflicting or unsupported parameters.
401	`unauthorized`	Missing or invalid service API key.
403	`restricted_page`	The resource is private or restricted.
404	`not_found`	Unknown route or missing resource.
429	`upstream_rate_limited`	Facebook throttled retrieval.
502	`upstream_challenged` `upstream_error` `unsupported_page`	Source challenge, failure or unsupported/mismatched structure.
502	`response_too_large` `payload_too_complex` `request_limit` `unsafe_redirect`	Bounded retrieval or fixed-origin policy failed.
503	`busy`	All Facebook worker slots are occupied.
504	`timeout`	Request deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/facebook/event/details?id=500000000000001" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/facebook/event/details?id=500000000000001",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/facebook/event/details?id=500000000000001",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Facebook Events request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/facebook/event/details",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "id": "500000000000001"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/facebook/event/details?id=500000000000001", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/facebook/event/details?id=500000000000001"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "id": "100000000000001",
  "series_id": null,
  "occurrence_id": null,
  "url": "https://www.facebook.com/synthetic.page/",
  "name": "Synthetic name",
  "description": null,
  "category": null,
  "categories": [],
  "is_online": null,
  "is_past": null,
  "event_kind": null,
  "privacy": null,
  "start_time": null,
  "end_time": null,
  "time_text": null,
  "duration": null,
  "price": null,
  "ticket_url": null,
  "ticket_source": null,
  "ticket_provider": null,
  "location_name": null,
  "address": null,
  "city": null,
  "city_id": null,
  "latitude": null,
  "longitude": null,
  "attendance_count": null,
  "attendance_facepile_count": null,
  "can_view_members": null,
  "host_context_text": null,
  "hosts": [],
  "host_names": [],
  "creator": null,
  "description_links": [],
  "can_viewer_message": null,
  "is_viewer_host": null,
  "is_canceled": null,
  "cover_photo_url": null,
  "day_time_sentence": null,
  "rsvp_style": null,
  "event_place": null,
  "price_info": null,
  "current_start_timestamp": null,
  "start_timestamp": null,
  "start_time_formatted": null,
  "interested_count": null,
  "going_count": null,
  "success": true,
  "status": "partial",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.facebook.com/synthetic.page/",
  "fetchedAt": "2026-09-12T00:00:00.000Z",
  "coverage": {
    "source": "public_web",
    "complete": false,
    "warnings": [
      "synthetic_example"
    ]
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 1200,
    "durationMs": 500
  }
}

Malformed, duplicate, conflicting or unsupported parameters.

{
  "success": false,
  "status": "failed",
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  },
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  }
}