Live Status

GET/v1/facebook/user/live1 credit

Tells whether a Facebook page or profile is live right now and how many people are watching; given a video URL, tells whether that video is a broadcast running now.

01Query parameters

Name	Type	Description
urlrequired	string	A Facebook page or profile URL (e.g. `https://www.facebook.com/aljazeerachannel`, `profile.php?id=…`), or a video URL (`/<page>/videos/<id>`, `/watch/?v=<id>`, `/reel/<id>`, `fb.watch/…`).

02Request

curl "https://api.scrapesocial.ai/v1/facebook/user/live?url=https%3A%2F%2Fwww.facebook.com%2Faljazeerachannel" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/user/live?url=https%3A%2F%2Fwww.facebook.com%2Faljazeerachannel

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "platform": "facebook",
  "is_live": true,
  "live_id": "1898592764464666",
  "title": "#تغطية_مباشرة | ترمب لفوكس نيوز: سؤالي حاليا هو هل أبرم اتفاقا مع الإيرانيين أم أقضي عليهم نهائيا",
  "started_at": "2026-10-25T15:52:19Z",
  "viewer_count": 371,
  "url": "https://www.facebook.com/aljazeerachannel/videos/1898592764464666/",
  "owner": {
    "id": "100064654032648",
    "username": "aljazeerachannel",
    "display_name": "Al Jazeera Channel - قناة الجزيرة"
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

This route is ours: ScrapeCreators has no Facebook live route. The answer is the same on every platform's live route: `platform`, `is_live`, `live_id`, `title`, `started_at` (ISO-8601 UTC), `viewer_count`, `url` and `owner` (`id`, `username`, `display_name`). A page that is not live is data too: `is_live: false` with the owner filled and the stream fields null, 1 credit. A value Facebook does not show is null (a reel's owner has no `username`). An unknown page returns a free 404 with `accountDoesNotExist: true`, an unknown video a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.