List Facebook profile reels

Try in Playground

Retrieve one public reels page with video metadata and rounded public view counts. view=full walks up to five pages and adds per-reel engagement; format=camelCase returns camelCase fields under data. Includes ordered media attachments with native IDs, GIF types and video rendition metadata.

GET/v1/facebook/profile/reelsx-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.

max 4096 chars

Examplehttps://www.facebook.com/synthetic.page/

cursorstringquery

Opaque continuation from this service. Preserve it exactly; cursors are source- and route-specific.

min 1 chars · max 16000 chars

next_page_idstringquery

Native profile collection ID returned with reels/photos pagination.

min 1 chars · max 2048 chars

sincenumber | stringquery

Earliest publication time to include, ISO 8601 or Unix seconds.

untilnumber | stringquery

Publication time to stop before, ISO 8601 or Unix seconds; later than since.

limitstringquery

Maximum result count: 1–100 for Marketplace or 1–50 for full reels. Full reels walk at most five pages within the same request budget.

viewenumquery

standard (default) returns one reels page; full walks up to five pages (limit, cursor, at most 50 reels) and adds per-reel engagement with item coverage.

one of: standard, full

formatenumquery

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

one of: native, camelCase

Response fields

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.

order is newest_first; window echoes since and until. Warnings name restricted, missing, interrupted or unavailable data.

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

coverage.orderenum

Always included.

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

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

up to 100 items

Always included.

up to 100 items

reels.mediaAttachments.idstring | numbernullable

Always included.

reels.mediaAttachments.indexinteger

Always included.

≥ 0

reels.mediaAttachments.typeenum

Always included.

one of: image, video, gif, unknown

reels.mediaAttachments.urlstringnullable

Always included.

reels.mediaAttachments.thumbnailUrlstringnullable

Always included.

reels.mediaAttachments.widthnumbernullable

Always included.

reels.mediaAttachments.heightnumbernullable

Always included.

reels.mediaAttachments.bestVideo.urlstring

Always included.

reels.mediaAttachments.bestVideo.widthnumbernullable

Always included.

reels.mediaAttachments.bestVideo.heightnumbernullable

Always included.

reels.mediaAttachments.bestVideo.bitratenumbernullable

Always included.

reels.mediaAttachments.bestVideo.hasAudiobooleannullable

Always included.

reels.mediaAttachments.bestVideo.sourceenum

Always included.

one of: progressive, dash

reels.mediaAttachments.bestVideo.mimeTypestringnullable

Always included.

reels.mediaAttachments.audioUrlstringnullable

Always included.

up to 100 items

reels.mediaAttachments.variants.urlstring

Always included.

reels.mediaAttachments.variants.widthnumbernullable

Always included.

reels.mediaAttachments.variants.heightnumbernullable

Always included.

reels.mediaAttachments.variants.bitratenumbernullable

Always included.

reels.mediaAttachments.variants.hasAudiobooleannullable

Always included.

reels.mediaAttachments.variants.sourceenum

Always included.

one of: progressive, dash

reels.mediaAttachments.variants.mimeTypestringnullable

Always included.

cursorstringnullable

Opaque continuation from this service. Preserve it exactly; cursors are source- and route-specific.

next_page_idstringnullable

Native profile collection ID returned with reels/photos pagination.

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

const response = await fetch(
  "https://api.scrapeatlas.com/v1/facebook/profile/reels?url=https%3A%2F%2Fwww.facebook.com%2Fsynthetic.page%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/profile/reels?url=https%3A%2F%2Fwww.facebook.com%2Fsynthetic.page%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/profile/reels",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.facebook.com/synthetic.page/"
    },
    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/profile/reels?url=https%3A%2F%2Fwww.facebook.com%2Fsynthetic.page%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/profile/reels?url=https%3A%2F%2Fwww.facebook.com%2Fsynthetic.page%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.

{
  "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",
    "order": "newest_first",
    "complete": false,
    "warnings": [
      "synthetic_example"
    ]
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 1200,
    "durationMs": 500
  },
  "reels": [],
  "cursor": null,
  "next_page_id": null
}

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
  }
}