Get a Facebook post or reel

Try in Playground

Retrieve one public post or reel with available media and engagement; optional comments and transcript reads preserve failures as nulls with warnings. view=transcript returns only the original caption file with SRT/WebVTT/XML cue timing; format=camelCase returns camelCase fields under data. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/postx-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

urlstringrequiredquery

Public HTTPS Facebook resource URL. Common tracking parameters are stripped; credentials, ports, lookalike hosts, traversal and unsupported paths are rejected. A shared_post_url from a post or group feed is accepted as is.

max 4096 chars

Examplehttps://www.facebook.com/reel/100000000000001/

get_commentsenumquery

true retrieves a bounded comment sample, with null plus an explicit warning if unavailable.

one of: true, false

get_transcriptenumquery

true retrieves available captions as plain text; null preserves unavailable captions.

one of: true, false

viewenumquery

standard (default) returns the post or reel; transcript returns only the original caption file (post_id, transcript) with cue timing preserved.

one of: standard, transcript

formatenumquery

native (default) returns the fields below; camelCase returns the same retrieval as camelCase fields under data.

one of: native, camelCase

Response fields

post_idstring

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

shared_post_idstringnullable

ID of the original post when this post shares another one and Facebook exposes it; otherwise null.

shared_post_urlstringnullable

URL of that original post, readable through this endpoint (pass it as url); null when unavailable.

like_countnumbernullable

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

comment_countnumbernullable

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

share_countnumbernullable

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

view_countnumbernullable

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

descriptionstringnullable

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

creation_timestringnullable

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

feedback_idstringnullable

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

urlstringnullable

Link preview of a link share: url (external destination), title, description, source and image_url; null for other posts.

link_attachment.urlstring

Always included.

link_attachment.titlestringnullable

Always included.

link_attachment.descriptionstringnullable

Always included.

link_attachment.sourcestringnullable

Always included.

link_attachment.image_urlstringnullable

Always included.

image_urlstringnullable

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

videoobjectnullable

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

Ordered media records on posts and reels; normalized records expose the same array under ext, and plural post details expose it under media.

up to 100 items

mediaAttachments.idstring | numbernullable

Always included.

mediaAttachments.indexinteger

Always included.

≥ 0

mediaAttachments.typeenum

Always included.

one of: image, video, gif, unknown

mediaAttachments.urlstringnullable

Always included.

mediaAttachments.thumbnailUrlstringnullable

Always included.

mediaAttachments.widthnumbernullable

Always included.

mediaAttachments.heightnumbernullable

Always included.

mediaAttachments.bestVideo.urlstring

Always included.

mediaAttachments.bestVideo.widthnumbernullable

Always included.

mediaAttachments.bestVideo.heightnumbernullable

Always included.

mediaAttachments.bestVideo.bitratenumbernullable

Always included.

mediaAttachments.bestVideo.hasAudiobooleannullable

Always included.

mediaAttachments.bestVideo.sourceenum

Always included.

one of: progressive, dash

mediaAttachments.bestVideo.mimeTypestringnullable

Always included.

mediaAttachments.audioUrlstringnullable

Always included.

up to 100 items

mediaAttachments.variants.urlstring

Always included.

mediaAttachments.variants.widthnumbernullable

Always included.

mediaAttachments.variants.heightnumbernullable

Always included.

mediaAttachments.variants.bitratenumbernullable

Always included.

mediaAttachments.variants.hasAudiobooleannullable

Always included.

mediaAttachments.variants.sourceenum

Always included.

one of: progressive, dash

mediaAttachments.variants.mimeTypestringnullable

Always included.

authorobjectnullable

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

musicobjectnullable

Public source music; 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.

coverage.orderenumoptional

Optional.

one of: newest_first, oldest_first, ranked, relevance, source_order

Optional.

coverage.window.sincestringoptional

Optional.

coverage.window.untilstringoptional

Optional.

Counted upstream requests, decoded response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsinteger

Always included.

≥ 0

commentsobject[]nullableoptional

Optional.

transcriptstringnullableoptional

Original published caption file text, including cue timing and line breaks; null when no public caption track is available.

comments_cursorstringnullableoptional

Optional.

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/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F100000000000001%2F" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F100000000000001%2F",
  {
    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/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F100000000000001%2F",
  {
    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 request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/facebook/post",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.facebook.com/reel/100000000000001/"
    },
    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/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F100000000000001%2F", 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/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F100000000000001%2F"))
            .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.

{
  "post_id": "Synthetic post_id",
  "shared_post_id": null,
  "shared_post_url": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "view_count": null,
  "description": null,
  "creation_time": null,
  "feedback_id": null,
  "url": null,
  "link_attachment": null,
  "image_url": null,
  "video": {
    "id": "200000000000001",
    "sd_url": null,
    "hd_url": "https://video.xx.fbcdn.net/synthetic-1080.mp4",
    "width": 2560,
    "height": 1440,
    "length_in_second": null,
    "thumbnail": "https://static.xx.fbcdn.net/synthetic.jpg",
    "captions_url": null
  },
  "author": null,
  "music": 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
  },
  "mediaAttachments": [
    {
      "id": "200000000000001",
      "index": 0,
      "type": "video",
      "url": "https://video.xx.fbcdn.net/synthetic-1080.mp4",
      "thumbnailUrl": "https://static.xx.fbcdn.net/synthetic.jpg",
      "width": 2560,
      "height": 1440,
      "bestVideo": {
        "url": "https://video.xx.fbcdn.net/synthetic-1440.mp4",
        "width": 2560,
        "height": 1440,
        "bitrate": 6000000,
        "hasAudio": false,
        "source": "dash",
        "mimeType": "video/mp4"
      },
      "audioUrl": "https://video.xx.fbcdn.net/synthetic-audio.mp4",
      "variants": [
        {
          "url": "https://video.xx.fbcdn.net/synthetic-1440.mp4",
          "width": 2560,
          "height": 1440,
          "bitrate": 6000000,
          "hasAudio": false,
          "source": "dash",
          "mimeType": "video/mp4"
        },
        {
          "url": "https://video.xx.fbcdn.net/synthetic-1080.mp4",
          "width": 1920,
          "height": 1080,
          "bitrate": null,
          "hasAudio": null,
          "source": "progressive",
          "mimeType": "video/mp4"
        }
      ]
    }
  ]
}

Malformed, duplicate, conflicting or unsupported parameters.

{
  "data": {},
  "hydration": {
    "total": 0,
    "enriched": 0,
    "failed": 0
  },
  "success": true,
  "status": "success",
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "sourceUrl": "https://example.com/",
  "fetchedAt": "2026-01-01T00:00:00.000Z",
  "coverage": {
    "source": "public_web",
    "complete": true,
    "warnings": [
      "string"
    ],
    "order": "newest_first",
    "window": {
      "since": "2026-01-01T00:00:00.000Z",
      "until": "2026-01-01T00:00:00.000Z"
    }
  },
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "post_id": "string",
  "transcript": "string"
}