# Scrapier — Facebook API > Scrapier endpoints for Facebook: Facebook Ad Library, Facebook Ad Library Leads, Facebook Ad Library Ad Transcript, Facebook Comment Replies and 15 more. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/facebook.md ## GET /facebook-ad-library/ Facebook Ad Library: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.ads Parameters: - urls (required, string, example https://www.facebook.com/ZapierApp): Facebook Ad Library URL (search or page) - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - ad_country (optional, string, default ALL, locked in cursor): Country filter. - ad_type (optional, string, default all, locked in cursor): Ad type filter, lowercase (e.g. 'all', 'political_and_issue_ads') -- Facebook's URL route is case-sensitive; 'ALL' uppercase silently narrows results. - ad_status (optional, string, default ALL, locked in cursor): Active / Inactive / ALL. - scrape_details (optional, boolean, default false, locked in cursor): Fetch full ad details per item (slower). - country (optional, string, default ALL): Default country code (e.g., ALL, US, IN) - period (optional, string): Facebook date_preset filter (e.g., ALL, LAST_30_DAYS) — leave empty to use URL default - active_status (optional, string, default all): Ad activity filter: all, active, or inactive - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-ad-library/?urls=https%3A%2F%2Fwww.facebook.com%2FZapierApp" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-ad-library.md ## GET /facebook-ad-library-leads/ Facebook Ad Library Leads: Structured Facebook data: send `urls`. Cursor-paginated, 2 credits per successful call. Cost: 2 credits per successful call · Pagination: cursor · Results: data.advertisers Parameters: - urls (required, string, example https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=plumber&search_type=keyword_unordered, locked in cursor): Ad Library search URL or public Page URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - country (optional, string, default ALL, locked in cursor): - active_status (optional, string, one of: active|inactive|all, default active, locked in cursor): - period (optional, string, locked in cursor): - max_landing_pages_per_advertiser (optional, integer, default 3, locked in cursor): - max_concurrent_sources (optional, integer, default 3): (no description yet) - max_concurrent_advertisers (optional, integer, default 5): (no description yet) - max_concurrent_crawls (optional, integer, default 10): (no description yet) - cookie_override (optional, string): (no description yet) - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-ad-library-leads/?urls=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%2F%3Factive_status%3Dactive%26ad_type%3Dall%26country%3DUS%26q%3Dplumber%26search_type%3Dkeyword_unordered" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-ad-library-leads.md ## GET /facebook-ad-library-transcript/ Facebook Ad Library Ad Transcript: Structured Facebook data: send `urls`. Single lookup, 3 credits per successful call. Cost: 3 credits per successful call · Pagination: single lookup · Results: data.ad Parameters: - urls (required, string, example 1700351324346955): Ad Library URL or bare numeric ad_archive_id. Lookup endpoint -- next_cursor null. - model_size (optional, string, one of: tiny|base|small|medium|large-v3, default base): (no description yet) - language (optional, string): (no description yet) - beam_size (optional, integer, default 2): (no description yet) - vad_filter (optional, boolean, default true): (no description yet) - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-ad-library-transcript/?urls=1700351324346955" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-ad-library-transcript.md ## GET /facebook-comment-replies/ Facebook Comment Replies: Structured Facebook data: send `feedback_id`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.replies Parameters: - feedback_id (required, string, example ZmVlZGJhY2s6NjM3NTIxOTM0MjU1MjExMl8xOTEwNzI1NzMwMDg2NDU=, locked in cursor): The top-level comment's id from a facebook-comments row: its `feedback_id` (base64 "feedback:_") or its `id` (base64 "comment:..."); a bare "_" also works. A post's own feedback id is rejected (400). Required first call. - expansion_token (optional, string, locked in cursor): Optional. The short-lived "View N replies" token; when omitted or expired a fresh one is resolved from feedback_id. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-comment-replies/?feedback_id=ZmVlZGJhY2s6NjM3NTIxOTM0MjU1MjExMl8xOTEwNzI1NzMwMDg2NDU%3D" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-comment-replies.md ## GET /facebook-comments/ Facebook Comments: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.comments Parameters: - urls (required, string, example https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl): Facebook post URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - include_replies (optional, boolean, default false, locked in cursor): Fetch replies per comment when true; false skips replies entirely. - max_reply_per_comment (optional, integer, default 2, locked in cursor): Max replies per top-level comment, or ALL (string) for no numeric cap. - comments_sort_order (optional, string, one of: all|newest|most_relevant, default all, locked in cursor): Comment order: all (every comment, oldest first) | newest | most_relevant (ranked by relevance, not by reaction count). Applied server-side before paging, so cursor pages never overlap or skip. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-comments/?urls=https%3A%2F%2Fwww.facebook.com%2Fhumansofnewyork%2Fposts%2Fpfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-comments.md ## GET /facebook-event-scraper/ Facebook Event Search: Structured Facebook data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.events Parameters: - queries (required, string, example Comedy): Event search keyword. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - location (optional, string, locked in cursor): NOT functional: accepted for input compatibility but never sent to Facebook. Confirmed live -- anonymous events-search resolves a city through a separate typeahead endpoint this scraper doesn't have, and sending a raw city name/id is silently WORSE than omitting it (Facebook accepts it with no error but returns zero events). - category (optional, string, locked in cursor): Event category (e.g. 'Comedy', 'Music and audio', 'Sports'). Matched live against Facebook's own category menu (case-insensitive, substring match) -- confirmed to change results. - time_filter (optional, string, locked in cursor): Date filter: a live preset label ('Today', 'Tomorrow', 'This week', 'This weekend', 'Next week', 'Next weekend', 'In the next month') or an explicit YYYY-MM-DD / YYYY-MM-DD~YYYY-MM-DD range. Confirmed live to change results. - details (optional, boolean, default false, locked in cursor): true = also open each event's own page (+~150 KB each) for full description, address/geo, organizers, child events. false = search-listing fields only. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-event-scraper/?queries=Comedy" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-event-scraper.md ## GET /facebook-group-posts/ Facebook Group Posts: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts Parameters: - urls (required, string, example https://www.facebook.com/groups/535363634111893): Facebook group URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - sort_by (optional, string, default RECENT_ACTIVITY, locked in cursor): Alias for view_option (CHRONOLOGICAL / RECENT_ACTIVITY / TOP_POSTS / CHRONOLOGICAL_LISTINGS); wins over view_option when both given. Resolved on the first call, - keywords (optional, string, locked in cursor): Optional keywords to filter posts by text (case-insensitive, comma-separated). - view_option (optional, string, default RECENT_ACTIVITY, locked in cursor): Sorting: CHRONOLOGICAL, RECENT_ACTIVITY, TOP_POSTS, CHRONOLOGICAL_LISTINGS. - search_group_keyword (optional, string, locked in cursor): Client-side filter by keyword/letter (single letter recommended) -- not a native Facebook search. - search_group_year (optional, string): Filter posts by year (e.g., "2024") - only_posts_newer_than (optional, string): Filter posts newer than date (YYYY-MM-DD, ISO, or relative like "2 months", "1 days") - cookie_string (optional, string): Facebook cookie string for authentication (optional but recommended) - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-group-posts/?urls=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F535363634111893" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-group-posts.md ## GET /facebook-group-profile/ Facebook Group Profile: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.profile Parameters: - urls (required, string, example https://www.facebook.com/groups/535363634111893): Facebook group URL. Lookup endpoint — next_cursor is always null. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-group-profile/?urls=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F535363634111893" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-group-profile.md ## GET /facebook-marketplace/ Facebook Marketplace: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.listings · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.facebook.com/marketplace/108479165840750/search/?query=phone): Marketplace search URL (with '?query=') or category/browse URL (e.g. /marketplace/category/vehicles, no query needed) — both return real listings fully anonymously. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - deepScrape (optional, boolean, default false, locked in cursor): Fetch detailed per-listing (PDP) data. - cookie_string (optional, string, locked in cursor): Optional Facebook session cookie ("c_user=...; xs=...") for a genuinely logged-in scrape. NOT required for baseline results. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-marketplace/?urls=https%3A%2F%2Fwww.facebook.com%2Fmarketplace%2F108479165840750%2Fsearch%2F%3Fquery%3Dphone" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-marketplace.md ## GET /facebook-page/ Facebook Page: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.page Parameters: - urls (required, string, example copperkettleyqr): Facebook page URL or username. Lookup endpoint — next_cursor is always null. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-page/?urls=copperkettleyqr" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-page.md ## GET /facebook-page-posts/ Facebook Page Posts: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.facebook.com/LombardOlkusz): Facebook page URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - newer_than (optional, string, locked in cursor): Optional ISO date or relative expression (e.g. "2 months") -- passed to Facebook's native afterTime timeline argument. Live-verified functional; most reliable when passed together with older_than as a bracket (Facebook's own profile "jump to date" UI always drives them together) — used alone with a mid-range value it can return an empty page even though newer posts exist. - older_than (optional, string, locked in cursor): Optional ISO date or relative expression (e.g. "1 months") -- passed to Facebook's native beforeTime timeline argument; live-verified to reliably shift results to posts created before this time. - cookie_string (optional, string, locked in cursor): Optional Facebook session cookie ("c_user=...; xs=...") for a logged-in scrape. NOT required for baseline results. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-page-posts/?urls=https%3A%2F%2Fwww.facebook.com%2FLombardOlkusz" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-page-posts.md ## GET /facebook-photos/ Facebook Photos: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.photos Parameters: - urls (required, string, example IamSRK): Facebook page/profile URL. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-photos/?urls=IamSRK" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-photos.md ## GET /facebook-profile-albums/ Facebook Profile Albums: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.items Parameters: - urls (required, string, example https://www.facebook.com/zuck): Facebook profile/page URL, Photos/Albums tab, single album URL, username or id. Required on the first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - page_size (optional, integer, default 20): Photos per page (max 100). - photos_newer_than (optional, string, locked in cursor): Date lower bound. - photos_older_than (optional, string, locked in cursor): Date upper bound. - enrich_photos (optional, boolean, default false, locked in cursor): Extra per-photo engagement query. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-profile-albums/?urls=https%3A%2F%2Fwww.facebook.com%2Fzuck" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-profile-albums.md ## GET /facebook-profile-events/ Facebook Profile Events: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.events Parameters: - urls (required, string, example https://www.facebook.com/RedRocksCO): One Facebook page/profile URL, username or numeric id. First only. Continue with the previous response next_cursor. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - scope (optional, string, one of: all|upcoming|past, default all, locked in cursor): Which collections to read. - newer_than (optional, string, locked in cursor): Start-time window low bound. - older_than (optional, string, locked in cursor): Start-time window high bound. - details (optional, boolean, default false, locked in cursor): Fetch per-event permalink extras. - locale (optional, string, default en_US, locked in cursor): Facebook locale. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-profile-events/?urls=https%3A%2F%2Fwww.facebook.com%2FRedRocksCO" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-profile-events.md ## GET /facebook-reels/ Facebook Reels: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.reels Parameters: - urls (required, string, example mrbeast): Facebook profile URL with reels. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-reels/?urls=mrbeast" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-reels.md ## GET /facebook-single-photo-scraper/ Facebook Single Photo Scraper: Structured Facebook data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.photo Parameters: - urls (required, string, example https://www.facebook.com/photo/?fbid=1616406629842169&set=a.271269304355915): Facebook photo URL or bare fbid. One photo per call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - post_stats (optional, boolean, default true): Also fetch containing-post comments/shares/reactions (default true). - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-single-photo-scraper/?urls=https%3A%2F%2Fwww.facebook.com%2Fphoto%2F%3Ffbid%3D1616406629842169%26set%3Da.271269304355915" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-single-photo-scraper.md ## GET /facebook-single-post-scraper/ Facebook Single Post Scraper: Structured Facebook data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.post · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.facebook.com/nytimes/posts/pfbid02WfD8kRLsDeXyaqA62K1p9eLE11SApY89ABXjNdNuiQKrizrJadhpxt67YfZ9Nkfl): Facebook post URL/id. Required. One post per call; next_cursor is always null. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-single-post-scraper/?urls=https%3A%2F%2Fwww.facebook.com%2Fnytimes%2Fposts%2Fpfbid02WfD8kRLsDeXyaqA62K1p9eLE11SApY89ABXjNdNuiQKrizrJadhpxt67YfZ9Nkfl" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-single-post-scraper.md ## GET /facebook-single-reel-scraper/ Facebook Single Reel Scraper: Structured Facebook data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.reel Parameters: - urls (required, string, example https://www.facebook.com/reel/1819667115884682): Facebook reel URL or bare id. One reel per call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-single-reel-scraper/?urls=https%3A%2F%2Fwww.facebook.com%2Freel%2F1819667115884682" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-single-reel-scraper.md ## GET /facebook-video-transcript/ Facebook Video Transcript: Structured Facebook data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.transcript Parameters: - urls (required, string, example https://www.facebook.com/reel/814948253914000): Facebook video URL. Lookup endpoint. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/facebook-video-transcript/?urls=https%3A%2F%2Fwww.facebook.com%2Freel%2F814948253914000" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/facebook/facebook-video-transcript.md