Skip to content
ScraperSocial API

Facebook API

Six endpoints under /v1/facebook/*. All are GET, authenticated with Authorization: Bearer sk_live_..., and return the standard { data, meta?, request_id } envelope. Public pages, posts, and Watch videos only — groups and private profiles are out of scope by design.

GET /v1/facebook/transcript

Full transcript of a Facebook video with timestamped segments.

Credits: 15 per video · Caching: Cached forever

Parameters

Name Description
url required Public Facebook content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/facebook/transcript?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1093831344793765" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "facebook",
    "entity_id": "1093831344793765",
    "language": "en",
    "source": "audio",
    "text": "Today I want to show you the three settings everyone ignores when they set this up for the first time...",
    "segments": [
      {
        "start": 0,
        "end": 3.2,
        "text": "Today I want to show you the three settings"
      },
      {
        "start": 3.2,
        "end": 5.9,
        "text": "everyone ignores when they set this up"
      }
    ]
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/facebook/summary

Short AI summary of a Facebook video, built on its transcript.

Credits: 17 per video · Caching: Cached forever

Parameters

Name Description
url required Public Facebook content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/facebook/summary?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1093831344793765" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "facebook",
    "entity_id": "1093831344793765",
    "language": "en",
    "summary": "A quick tutorial covering three commonly missed configuration steps, with a before/after comparison and a call to check the pinned comment for the full guide."
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/facebook/stats

Reactions, comments and shares for a Facebook post or video.

Credits: 5 per post · Caching: Age-aware cache (15 min - 7 days)

Parameters

Name Description
url required Public Facebook content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/facebook/stats?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1093831344793765" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "facebook",
    "entity_id": "1093831344793765",
    "url": "https://www.facebook.com/watch/?v=1093831344793765",
    "author": {
      "handle": "facebook",
      "name": "Example Creator"
    },
    "posted_at": "2026-06-30T14:05:00Z",
    "metrics": {
      "views": 1204593,
      "likes": 88410,
      "comments": 2314,
      "shares": 10092
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/facebook/comments

Paginated comments on a Facebook post; charged per comment returned.

Credits: 3 per comment · Caching: Age-aware cache (15 min - 7 days) · Paginated (cursor/limit)

Parameters

Name Description
url required Public Facebook content URL.
limit optional Items per page (default 20, max 50 sync; larger via async jobs).
cursor optional Opaque cursor from the previous page's meta.cursor.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/facebook/comments?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1093831344793765" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "c_9021",
      "text": "This fixed it for me, thank you",
      "author": {
        "handle": "dev.casey"
      },
      "likes": 412,
      "posted_at": "2026-07-01T09:12:00Z"
    },
    {
      "id": "c_9022",
      "text": "Can you do a follow-up on the advanced settings?",
      "author": {
        "handle": "mariana.codes"
      },
      "likes": 96,
      "posted_at": "2026-07-01T10:44:00Z"
    }
  ],
  "meta": {
    "count": 2,
    "limit": 50,
    "cursor": "eyJvZmZzZXQiOjUwfQ",
    "has_more": true
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/facebook/page-stats

Followers, likes and metadata for a Facebook page.

Credits: 10 per page · Caching: Cached 12 hours

Parameters

Name Description
url | handle one required Public Facebook URL, or the handle.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/facebook/page-stats?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1093831344793765" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "facebook",
    "handle": "facebook",
    "name": "Example Creator",
    "bio": "Tutorials and behind-the-scenes. New video every Tuesday.",
    "verified": true,
    "metrics": {
      "followers": 2450318,
      "following": 132,
      "posts": 842
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/facebook/download

Resolves a downloadable media URL for a Facebook video (URL expires within 1h).

Credits: 10 per video · Caching: Cached 7 days (media URLs max 1h)

Parameters

Name Description
url required Public Facebook content URL.
fresh optional true bypasses the cache at the same credit price.
format optional json (default), csv or text where applicable.

Request

Terminal window
curl "https://api.scrapersocial.com/v1/facebook/download?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1093831344793765" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "facebook",
    "entity_id": "1093831344793765",
    "media_url": "https://cdn.example/video/master.mp4?sig=...",
    "mime_type": "video/mp4",
    "expires_at": "2026-07-15T13:00:00Z",
    "warning": "media_url is short-lived (max 1h) — download promptly or re-request."
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

Related: Instagram API · X/Twitter API · Errors