brightdata-facebook-scraper 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,997 @@
1
+ Metadata-Version: 2.5
2
+ Name: brightdata-facebook-scraper
3
+ Version: 0.1.0
4
+ Summary: Facebook scraper in Python: page and group posts, comments, reels, pages, profiles, reviews, Marketplace, events and Meta Ad Library as JSON, on the Bright Data Facebook Scraper API. No Facebook login, no Graph API, no dependencies. 5,000 free credits a month.
5
+ Project-URL: Homepage, https://github.com/brightdata/facebook-scraper
6
+ Project-URL: Documentation, https://docs.brightdata.com/products/scrapers/facebook/introduction
7
+ Project-URL: Source, https://github.com/brightdata/facebook-scraper
8
+ Project-URL: Issues, https://github.com/brightdata/facebook-scraper/issues
9
+ Project-URL: Changelog, https://github.com/brightdata/facebook-scraper/blob/main/CHANGELOG.md
10
+ Author: Bright Data
11
+ License: Apache-2.0
12
+ License-File: LICENSE
13
+ Keywords: bright-data,facebook,facebook-api,facebook-scraper,groups,pages,posts,scraper,web-scraping
14
+ Classifier: Development Status :: 4 - Beta
15
+ Classifier: Intended Audience :: Developers
16
+ Classifier: License :: OSI Approved :: Apache Software License
17
+ Classifier: Operating System :: OS Independent
18
+ Classifier: Programming Language :: Python :: 3
19
+ Classifier: Programming Language :: Python :: 3 :: Only
20
+ Classifier: Topic :: Internet :: WWW/HTTP
21
+ Requires-Python: >=3.10
22
+ Provides-Extra: dev
23
+ Requires-Dist: pytest>=8; extra == 'dev'
24
+ Requires-Dist: ruff>=0.6; extra == 'dev'
25
+ Description-Content-Type: text/markdown
26
+
27
+ # Facebook scraper for Python
28
+
29
+ Scrape Facebook posts, comments, reels, Marketplace, events and Meta Ad Library to JSON with Python. No Facebook login, no Graph API.
30
+ Built on the [Bright Data Facebook Scraper API](https://brightdata.com/products/web-scraper/facebook?utm_source=github&utm_medium=referral&utm_content=facebook-scraper). New accounts get 5,000 free credits a month.
31
+
32
+ [![Live check](https://github.com/brightdata/facebook-scraper/actions/workflows/live.yml/badge.svg)](https://github.com/brightdata/facebook-scraper/actions/workflows/live.yml)
33
+ [![last verified](https://img.shields.io/badge/last%20verified-11%20Nov%202026-brightgreen)](https://github.com/brightdata/facebook-scraper/actions/workflows/live.yml) <!-- verified: rewritten by the weekly run -->
34
+
35
+ [Quickstart](#how-to-scrape-facebook-posts-with-python) · [No login](#scrape-facebook-without-a-login-or-the-graph-api) · [CLI](#bulk-facebook-page-posts-cli) · [Endpoints](#scrape-facebook-posts-comments-marketplace-events-and-ads) · [Data](#facebook-post-data-fields-json) · [Errors](#facebook-scraper-errors) · [MCP and Claude Code](#facebook-mcp-server-and-claude-code-skill) · [Free credits](#is-this-facebook-scraper-free) · [Docs](https://docs.brightdata.com/products/scrapers/facebook/introduction) · [Support](#support)
36
+
37
+ Facebook data as JSON, in Python: page and group posts, comments, reels, page
38
+ details, profiles, reviews, Marketplace listings, events and the Meta Ad
39
+ Library. All eleven Bright Data Facebook scrapers, one function each. No
40
+ Facebook login, no browser, no dependencies. Built on the
41
+ [Bright Data Facebook Scraper API](https://brightdata.com/products/web-scraper/facebook?utm_source=github&utm_medium=referral&utm_content=facebook-scraper).
42
+
43
+ Also here: a one-command CLI for page posts, and the
44
+ [Bright Data CLI](#facebook-mcp-server-and-claude-code-skill), which needs no Python at all.
45
+
46
+ ## How to scrape Facebook posts with Python
47
+
48
+ Python 3.10 or newer, and nothing to install: this is the standard library.
49
+
50
+ ```bash
51
+ export BRIGHTDATA_API_TOKEN=YOUR_API_KEY
52
+ ```
53
+
54
+ Get a token from the
55
+ [Bright Data control panel](https://brightdata.com/cp/setting/users). No
56
+ account yet? [Create one](https://brightdata.com/cp/start); new accounts get
57
+ [5,000 free credits a month](https://docs.brightdata.com/general/account/billing-and-pricing/free-tier).
58
+
59
+ ```python
60
+ import json
61
+ import os
62
+ import time
63
+ import urllib.request
64
+
65
+ API = "https://api.brightdata.com/datasets/v3"
66
+ HEADERS = {
67
+ "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_TOKEN']}",
68
+ "Content-Type": "application/json",
69
+ }
70
+
71
+
72
+ def call(path, body=None):
73
+ data = None if body is None else json.dumps(body).encode()
74
+ request = urllib.request.Request(API + path, data=data, headers=HEADERS)
75
+ with urllib.request.urlopen(request) as response:
76
+ return json.load(response)
77
+
78
+
79
+ page = {"url": "https://www.facebook.com/Meta", "num_of_posts": 3}
80
+ job = call("/trigger?dataset_id=gd_lkaxegm826bjpoo9m5&include_errors=true", [page])
81
+ while call(f"/progress/{job['snapshot_id']}")["status"] not in ("ready", "failed"):
82
+ time.sleep(10)
83
+ for post in call(f"/snapshot/{job['snapshot_id']}?format=json"):
84
+ if "error" in post:
85
+ raise SystemExit(post["error"])
86
+ print(post["likes"], post["num_comments"], post["url"])
87
+ ```
88
+
89
+ ```
90
+ 723 342 https://www.facebook.com/Meta/posts/pfbid0evGHWPACd3JninWg3j3nucQjdFxoHWwJSPgFXKjZXaUiU8MctREDPRZZsAps6CGwl
91
+ 4169 717 https://www.facebook.com/reel/2300984144015832/
92
+ 7679 819 https://www.facebook.com/reel/29074877795478111/
93
+ ```
94
+
95
+ Expect one to three minutes: the API runs a job and the loop waits for it.
96
+ Billed [per post](https://brightdata.com/pricing/web-scraper).
97
+
98
+ Two things in that snippet are not optional.
99
+
100
+ `num_of_posts` caps the run, and the bill. Without it a page returns, and
101
+ charges for, every post the scraper can reach.
102
+
103
+ `include_errors=true` makes the API report a dead or private page as a row
104
+ with an `error` key. The API default is off, and a failed page then looks the
105
+ same as a page with no posts.
106
+
107
+ The Bright Data [Python SDK](https://github.com/brightdata/sdk-python) wraps
108
+ five of the eleven Facebook scrapers, and the API rejects the
109
+ `num_of_comments` input its comments call sends. Hence the plain HTTP, here
110
+ and in this package.
111
+
112
+ ## Scrape Facebook without a login or the Graph API
113
+
114
+ The Facebook Scraper API needs no Facebook account, no Facebook login, no Meta
115
+ app and no Graph API access token. The only credential is a Bright Data API
116
+ key, set as `BRIGHTDATA_API_TOKEN`. This package and its command also find the
117
+ key stored by `bdata login`. It collects what a logged-out visitor can see: a
118
+ private group or profile comes back as an error row.
119
+
120
+ ## Bulk Facebook page posts CLI
121
+
122
+ The command in this repo runs the Python quickstart for several pages at once
123
+ and writes one JSON file.
124
+
125
+ ```bash
126
+ pip install git+https://github.com/brightdata/facebook-scraper
127
+ facebook-scraper Meta Microsoft --limit 2
128
+ ```
129
+
130
+ ```
131
+ Fetching up to 2 recent posts per page, for: Meta, Microsoft
132
+ Usually one to three minutes each. Billed per post, 5,000 free credits a month.
133
+ asking Meta...
134
+ got Meta: 2 posts
135
+ asking Microsoft...
136
+ got Microsoft: 2 posts
137
+
138
+ Saved 4 posts as JSON to facebook.json (44 fields per post)
139
+ ```
140
+
141
+ In a terminal the `asking` lines are replaced by a spinner and a running
142
+ clock, updating in place, so you can see it is working and how long it has
143
+ been going.
144
+
145
+ ```
146
+ --limit N posts per page, default 5, minimum 1
147
+ --out PATH output file, default facebook.json
148
+ ```
149
+
150
+ A page can be a name, `@Meta`, `facebook.com/Meta` or a full URL.
151
+ `python -m facebook_scraper` works too. The command finds the token in
152
+ `BRIGHTDATA_API_TOKEN`, or, if you ran `npx -p @brightdata/cli bdata login`
153
+ once, in the stored login, for you and for any coding agent in that terminal.
154
+
155
+ Import it instead of running it, for `ok`, `note` and `error` per page instead
156
+ of raw rows. `scrape` never raises for one bad page; check `ok` before reading
157
+ `posts`:
158
+
159
+ ```python
160
+ from facebook_scraper import scrape
161
+
162
+ for outcome in scrape(["Meta", "zzqqxx-no-such-page-404"], limit=1):
163
+ if outcome.ok:
164
+ print(f"{outcome.page}: {len(outcome.posts)} posts")
165
+ else:
166
+ print(f"{outcome.page} failed: {outcome.error}")
167
+ ```
168
+
169
+ ```
170
+ Meta: 1 posts
171
+ zzqqxx-no-such-page-404 failed: Posts not found
172
+ ```
173
+
174
+ A page that does not exist comes back as an error row, "Posts not found",
175
+ and it takes the longest: 459 seconds for that run. When a run returns some
176
+ posts and some error rows, the posts are kept, and the errors land in `note`.
177
+
178
+ ## Scrape Facebook posts, comments, Marketplace, events and ads
179
+
180
+ Bright Data has eleven Facebook scrapers, each documented in the
181
+ [Facebook Scraper API docs](https://docs.brightdata.com/products/scrapers/facebook/introduction).
182
+ This package has one function for each way to call them. Every snippet below
183
+ is complete: paste it as is after the `pip install` above. Every one of them
184
+ runs in Actions each Monday, a smaller check runs every other day, and the
185
+ badge at the top is the latest result.
186
+
187
+ | you have | want | how |
188
+ | --- | --- | --- |
189
+ | page URLs | their recent posts | `page_posts(urls, 5)` |
190
+ | public group URLs | their recent posts | `group_posts(urls, 5)` |
191
+ | post URLs | those posts | `posts(urls)` |
192
+ | post URLs | their comments | `comments(urls, 10)`, billed per comment |
193
+ | page URLs | their recent reels | `reels(urls, 5)` |
194
+ | page URLs | page details: followers, category, contact info | `pages(urls)` |
195
+ | profile URLs of people | public profile details | `profiles(urls)` |
196
+ | a page's `/reviews/` URL | its reviews | `reviews(urls, 10)` |
197
+ | a keyword and a city | Marketplace listings | `marketplace_search("bicycle", "New York", 5)` |
198
+ | a Marketplace category URL | its listings | `marketplace_category(url, 5)` |
199
+ | Marketplace item URLs | those listings | `marketplace(urls)` |
200
+ | a venue page's `/events` URL | its upcoming events | `events_by_venue(url, 5)` |
201
+ | an events search URL | matching events | `events_search(url, 5)` |
202
+ | event URLs | those events | `events(urls)` |
203
+ | a keyword and a country | ads in the Meta Ad Library | `ads_search("coffee", "US", 5)` |
204
+ | Ad Library ad URLs | those ads | `ads(urls)` |
205
+
206
+ Each takes one URL or a list. A list is one job, not one per URL. Each returns
207
+ a list of rows, and a row the API could not collect carries an `error` key
208
+ instead of the record. Functions that take a limit pass any other input the
209
+ API accepts as a keyword argument, named as the API names it:
210
+ `page_posts(url, 10, start_date="10-01-2026")`.
211
+
212
+ ### Scrape Facebook page posts from several pages in one job
213
+
214
+ ```python
215
+ from facebook_scraper import page_posts
216
+
217
+ urls = ["https://www.facebook.com/Meta", "https://www.facebook.com/Microsoft"]
218
+ for post in page_posts(urls, 1):
219
+ print(post["page_name"], post["date_posted"], post["likes"], post["url"])
220
+ ```
221
+
222
+ ```
223
+ Microsoft 2025-04-04T22:18:26.000Z 40838 https://www.facebook.com/Microsoft/posts/pfbid0347J66TDSqDpBtUS5Vmhu17t7bpCWTRzgi9yWw1387gGCJuwhAdKfsLzByvA93uRcl
224
+ Meta 2026-10-30T19:41:31.000Z 723 https://www.facebook.com/Meta/posts/pfbid0evGHWPACd3JninWg3j3nucQjdFxoHWwJSPgFXKjZXaUiU8MctREDPRZZsAps6CGwl
225
+ ```
226
+
227
+ ### Scrape Facebook group posts
228
+
229
+ Public groups only. The records name the people who posted; this prints the
230
+ group and the counts.
231
+
232
+ ```python
233
+ from facebook_scraper import group_posts
234
+
235
+ for post in group_posts("https://www.facebook.com/groups/532855527252024", 2):
236
+ print(post["group_name"][:40], post["group_members"], post["date_posted"], post["num_comments"])
237
+ ```
238
+
239
+ ```
240
+ Jobs, Work and Vacancies in Cape Town an 238700 2026-11-03T18:53:25.000Z 0
241
+ Jobs, Work and Vacancies in Cape Town an 238700 2026-11-03T18:48:29.000Z 0
242
+ ```
243
+
244
+ ### Scrape a Facebook post by URL
245
+
246
+ ```python
247
+ from facebook_scraper import posts
248
+
249
+ url = "https://www.facebook.com/Meta/posts/pfbid0evGHWPACd3JninWg3j3nucQjdFxoHWwJSPgFXKjZXaUiU8MctREDPRZZsAps6CGwl"
250
+ post = posts(url)[0]
251
+ print(post["user_username_raw"], post["likes"], post["num_comments"], post["num_shares"])
252
+ print(post["content"][:70])
253
+ ```
254
+
255
+ ```
256
+ Meta 593 342 194
257
+ Meta Ray-Ban Display has been out for a while, so if you’re a develope
258
+ ```
259
+
260
+ ### Scrape Facebook comments from a post
261
+
262
+ Billed per comment, so check `num_comments` on the post first. The limit
263
+ goes to the API as `limit_records`.
264
+
265
+ ```python
266
+ from facebook_scraper import comments
267
+
268
+ url = "https://www.facebook.com/Meta/posts/pfbid0evGHWPACd3JninWg3j3nucQjdFxoHWwJSPgFXKjZXaUiU8MctREDPRZZsAps6CGwl"
269
+ rows = comments(url, 3)
270
+ print(len(rows), "comments; first:", rows[0]["date_created"], rows[0]["num_likes"], "likes")
271
+ ```
272
+
273
+ ```
274
+ 3 comments; first: 2026-10-31T01:48:29.000Z 10 likes
275
+ ```
276
+
277
+ ### Scrape Facebook reels from a page
278
+
279
+ ```python
280
+ from facebook_scraper import reels
281
+
282
+ for reel in reels("https://www.facebook.com/Meta", 2):
283
+ print(reel["date_posted"], reel["video_view_count"], "views", reel["url"])
284
+ ```
285
+
286
+ ```
287
+ 2026-10-27T16:44:32.000Z 447000 views https://www.facebook.com/reel/2300984144015832
288
+ 2026-10-22T16:25:44.000Z 1200000 views https://www.facebook.com/reel/29074877795478111
289
+ ```
290
+
291
+ ### Scrape Facebook page data
292
+
293
+ ```python
294
+ from facebook_scraper import pages
295
+
296
+ page = pages("https://www.facebook.com/Meta")[0]
297
+ print(page["page_name"], page["followers"], "followers,", page["primary_category"])
298
+ ```
299
+
300
+ ```
301
+ Meta 106000000 followers, Company
302
+ ```
303
+
304
+ ### Scrape a Facebook profile
305
+
306
+ Public profile details only, what a logged-out visitor sees.
307
+
308
+ ```python
309
+ from facebook_scraper import profiles
310
+
311
+ profile = profiles("https://www.facebook.com/zuck")[0]
312
+ print(profile["name"], "|", profile["city"])
313
+ ```
314
+
315
+ ```
316
+ Mark Zuckerberg | Palo Alto
317
+ ```
318
+
319
+ ### Scrape Facebook reviews of a business page
320
+
321
+ Pass the page's `/reviews/` URL. Many brand pages have reviews turned off and
322
+ return an error row, "Reviews not found" or a dead page, instead of zero rows.
323
+ This prints the verdicts, not the reviewers.
324
+
325
+ ```python
326
+ from facebook_scraper import reviews
327
+
328
+ for review in reviews("https://www.facebook.com/TheGarden/reviews/", 3):
329
+ print(review["company_name"], review["review_time"], "recommends:", review["recommends"])
330
+ ```
331
+
332
+ ```
333
+ Madison Square Garden 2026-10-31T14:43:54.000Z recommends: True
334
+ Madison Square Garden 2026-10-21T12:28:03.000Z recommends: True
335
+ Madison Square Garden 2026-10-19T22:29:17.000Z recommends: False
336
+ ```
337
+
338
+ ### Scrape Facebook Marketplace listings
339
+
340
+ ```python
341
+ from facebook_scraper import marketplace_search
342
+
343
+ for item in marketplace_search("bicycle", "New York", 3):
344
+ if "error" not in item: # rows the limit cancelled carry only an error
345
+ print(item["final_price"], item["currency"], item["title"][:40], "|", item["location"])
346
+ ```
347
+
348
+ ```
349
+ 100 USD Bikes for sale like new | Perth Amboy, NJ
350
+ 100 USD bicycle | Linden, NJ
351
+ 350 USD 700c Whls 24 Spd Medium Frame Cannondale | Brooklyn, NY
352
+ ```
353
+
354
+ `marketplace_category(url, 5)` does the same from a category URL, such as
355
+ `https://www.facebook.com/marketplace/category/vehicles`, and
356
+ `marketplace(urls)` collects listings you already have the URLs of.
357
+
358
+ ### Scrape Facebook events at a venue
359
+
360
+ Pass the venue page's `/events` URL. The bare page URL finds no events.
361
+
362
+ ```python
363
+ from facebook_scraper import events_by_venue
364
+
365
+ for event in events_by_venue("https://www.facebook.com/TheGarden/events", 3):
366
+ print(event["event_date"], event["title"])
367
+ ```
368
+
369
+ ```
370
+ 2026-11-04T00:00:00.000Z New York Rangers vs. St. Louis Blues
371
+ 2026-11-05T00:30:00.000Z New York Knicks vs. Chicago Bulls
372
+ 2026-11-04T00:00:00.000Z NY Rangers vs St. Louis Blues Premium Seating
373
+ ```
374
+
375
+ `events_search(url, 5)` takes an events search URL, such as
376
+ `https://www.facebook.com/events/search/?q=marathon`. Its matching is loose:
377
+ check the titles it returns.
378
+
379
+ ### Scrape the Facebook Ad Library
380
+
381
+ ```python
382
+ from facebook_scraper import ads_search
383
+
384
+ for ad in ads_search("coffee", "US", 3):
385
+ if "error" not in ad: # rows the limit cancelled carry only an error
386
+ print(ad["advertiser_name"], "| active:", ad["is_active"], "| since", ad["start_date"])
387
+ ```
388
+
389
+ ```
390
+ Wall Stadium | active: True | since 2026-04-22T07:00:00.000Z
391
+ Biggby Coffee of Wickliffe Ohio | active: True | since 2025-04-29T07:00:00.000Z
392
+ Dame Fine Coffee | active: True | since 2026-06-11T07:00:00.000Z
393
+ ```
394
+
395
+ `ad_type` defaults to `"All ads"`, the value the API validates; `"all"` is
396
+ rejected. A discovery that reaches its limit cancels the crawls still running,
397
+ and each comes back as a row whose error is "Crawl aborted on job cancel".
398
+ `split()` treats those as the limit working, not as failures.
399
+
400
+ ### Trigger now, fetch later
401
+
402
+ For anything bigger than a few pages, do not block a process for an hour.
403
+ Trigger, keep the snapshot id, fetch when ready. Snapshots stay downloadable
404
+ for 30 days.
405
+
406
+ ```python
407
+ import time
408
+
409
+ from facebook_scraper import PAGES, fetch, status, trigger
410
+
411
+ snapshot = trigger(PAGES, [{"url": "https://www.facebook.com/Microsoft"}])
412
+ print("snapshot:", snapshot)
413
+ while (state := status(snapshot)) not in ("ready", "failed"):
414
+ time.sleep(10)
415
+ print("status:", state)
416
+ print("fetched:", fetch(snapshot)[0]["page_name"])
417
+ ```
418
+
419
+ ```
420
+ snapshot: sd_mw12itsz2eyr9m4tcu
421
+ status: ready
422
+ fetched: Microsoft
423
+ ```
424
+
425
+ `trigger` takes any dataset, `discover_by` and `limit_per_input`, so it reaches
426
+ every scraper in the table. Each input was accepted by the live API on
427
+ 2026-11-03, and several differ from the API reference pages:
428
+
429
+ | scraper | dataset_id | discover_by | input |
430
+ | --- | --- | --- | --- |
431
+ | Page posts | `gd_lkaxegm826bjpoo9m5` | none | `{"url", "num_of_posts"}` |
432
+ | Group posts | `gd_lz11l67o2cb3r0lkj3` | none | `{"url", "num_of_posts"}` |
433
+ | Post by URL | `gd_lyclm1571iy3mv57zw` | none | `{"url"}` |
434
+ | Comments | `gd_lkay758p1eanlolqw8` | none | `{"url", "limit_records"}`. `num_of_comments` is rejected |
435
+ | Reels | `gd_lyclm3ey2q6rww027t` | none | `{"url", "num_of_posts"}` |
436
+ | Pages | `gd_mf124a0511bauquyow` | none | `{"url"}` |
437
+ | Profiles | `gd_mf0urb782734ik94dz` | none | `{"url"}` |
438
+ | Company reviews | `gd_m0dtqpiu1mbcyc2g86` | none | `{"url", "num_of_reviews"}`, a `/reviews/` URL |
439
+ | Marketplace item | `gd_lvt9iwuh6fbcwmx1a` | none | `{"url"}` |
440
+ | Marketplace search | `gd_lvt9iwuh6fbcwmx1a` | `keyword` | `{"keyword", "city"}` required |
441
+ | Marketplace category | `gd_lvt9iwuh6fbcwmx1a` | `url` | `{"url"}` |
442
+ | Event | `gd_m14sd0to1jz48ppm51` | none | `{"url"}` |
443
+ | Events search | `gd_m14sd0to1jz48ppm51` | `url` | `{"url"}`, an `/events/search/?q=` URL |
444
+ | Events at a venue | `gd_m14sd0to1jz48ppm51` | `venue` | `{"url", "upcoming_events_only"}`, a `/events` URL |
445
+ | Ad | `gd_mtveskb62h7q65ftgz` | none | `{"url"}` |
446
+ | Ads search | `gd_mtveskb62h7q65ftgz` | `keyword` | `{"keyword", "country", "ad_type"}`, `ad_type` `"All ads"` |
447
+
448
+ `bdata pipelines info <dataset_id> <method>` prints the input fields the API
449
+ validates.
450
+
451
+ ## Facebook post data fields (JSON)
452
+
453
+ The fields most people want from a page post:
454
+
455
+ ```
456
+ url date_posted content likes num_comments num_shares page_name page_followers
457
+ ```
458
+
459
+ The code hardcodes no field list. Whatever the API returns lands in each row,
460
+ and in the command's file.
461
+
462
+ <!-- fields:start -->
463
+ Regenerated every week from the published schema,
464
+ [scrapers-full.json](https://docs.brightdata.com/scrapers-full.json), so they cannot go stale. A record
465
+ carries the fields that apply to it, plus `timestamp` and `input`; the
466
+ sample file's first post has 44 keys.
467
+
468
+ <details>
469
+ <summary>All 52 page post fields, <code>gd_lkaxegm826bjpoo9m5</code></summary>
470
+
471
+ | field | type | description |
472
+ | --- | --- | --- |
473
+ | `url` | url | Facebook post URL |
474
+ | `post_id` | text | Unique identifier for each Facebook post |
475
+ | `user_url` | url | Unique identifier for each Facebook post |
476
+ | `user_username_raw` | text | Username of the user who posted the content |
477
+ | `content` | text | Text or media content of the post |
478
+ | `date_posted` | date | Date and time when the post was published |
479
+ | `hashtags` | array | Hashtags used in the post |
480
+ | `num_comments` | number | Number of comments on the post |
481
+ | `num_shares` | number | Number of shares of the post |
482
+ | `num_likes_type` | object | Type of likes received: The data point "count_reactions_type" contains all reactions received. |
483
+ | `page_name` | text | Name of the Facebook page where the post was published |
484
+ | `profile_id` | text | Unique identifier for the user's profile |
485
+ | `page_intro` | text | Introduction or description of the Facebook page |
486
+ | `page_category` | text | Category of the Facebook page |
487
+ | `page_logo` | image | Logo of the Facebook page |
488
+ | `page_external_website` | text | External website associated with the Facebook page |
489
+ | `page_likes` | number | Number of likes on the Facebook page |
490
+ | `page_followers` | number | Number of followers of the Facebook page |
491
+ | `page_is_verified` | boolean | Verification status of the Facebook page |
492
+ | `original_post` | object | Indicates if the post is original or a repost |
493
+ | `attachments` | array | Media attachments included in the post |
494
+ | `other_posts_url` | array | Web address of other posts by the same user |
495
+ | `post_external_link` | url | External link included in the post |
496
+ | `post_external_title` | text | Title of the external link |
497
+ | `post_external_image` | url | Post external link image |
498
+ | `page_url` | url | Web address of the Facebook page |
499
+ | `header_image` | image | Header image of the Facebook page |
500
+ | `avatar_image_url` | text | The URL of the avatar image of the Facebook page |
501
+ | `profile_handle` | text | The handle or username of the Facebook page |
502
+ | `has_handshake` | text | Indicates if the post has a handshake |
503
+ | `is_sponsored` | boolean | Indicates whether the post is sponsored or not |
504
+ | `sponsor_name` | text | The name of the sponsor if the post is sponsored |
505
+ | `shortcode` | text | The shortcode of the post URL |
506
+ | `video_view_count` | number | The number of views if the post contains a video |
507
+ | `likes` | number | The number of likes on the post |
508
+ | `post_image` | image | post image url if exists |
509
+ | `post_type` | text | The type of the post |
510
+ | `following` | number | Number of profiles following |
511
+ | `link_description_text` | text | The text that is visible under the link title |
512
+ | `count_reactions_type` | array | Type of reactions received |
513
+ | `is_page` | boolean | Is the post from a page or a profile |
514
+ | `page_phone` | text | Public phone number listed on the page |
515
+ | `page_email` | text | Public email address listed on the page |
516
+ | `page_creation_time` | date | Date the page was created |
517
+ | `page_reviews_score` | text | Average page review score |
518
+ | `page_reviewers_amount` | number | Total number of page reviewers |
519
+ | `page_price_range` | text | Price range label shown on the page |
520
+ | `about` | array | Key-value pairs extracted from the page’s About section |
521
+ | `active_ads_urls` | array | Links to the page’s active ads in Facebook Ad Library |
522
+ | `delegate_page_id` | text | ID of the page shown as responsible for this page |
523
+ | `privacy_and_legal_info` | text | The privacy and legal info of the profile |
524
+ | `play_count` | number | Represents the number of times the video started playing (or was clicked to play) |
525
+
526
+ </details>
527
+
528
+ <details>
529
+ <summary>All 44 group post fields, <code>gd_lz11l67o2cb3r0lkj3</code></summary>
530
+
531
+ | field | type | description |
532
+ | --- | --- | --- |
533
+ | `url` | url | URL |
534
+ | `post_id` | text | Unique identifier for each Facebook post |
535
+ | `user_url` | url | Unique identifier for each Facebook post |
536
+ | `user_username_raw` | text | Username of the user who posted the content |
537
+ | `content` | text | Text or media content of the post |
538
+ | `date_posted` | date | Date and time when the post was published |
539
+ | `hashtags` | array | Hashtags used in the post |
540
+ | `num_comments` | number | Number of comments on the post |
541
+ | `num_shares` | number | Number of shares of the post |
542
+ | `num_likes_type` | object | Type of likes received (e.g., reactions, thumbs-up) |
543
+ | `group_name` | text | Name of the Facebook group where the post was published |
544
+ | `group_id` | text | Unique identifier for the user's profile |
545
+ | `group_url` | url | Web address of the Facebook group |
546
+ | `group_intro` | text | Introduction or description of the Facebook group |
547
+ | `group_category` | text | Category of the Facebook group |
548
+ | `group_logo` | image | Logo of the Facebook group |
549
+ | `group_external_website` | text | External website associated with the Facebook group |
550
+ | `group_members` | number | Number of members of the Facebook group |
551
+ | `group_created_at` | date | The date When the group was created |
552
+ | `user_is_verified` | boolean | Verification status of the Facebook user who posted |
553
+ | `original_post` | object | Indicates if the post is original or a repost |
554
+ | `attachments` | array | Attachments |
555
+ | `other_posts_url` | array | Web address of other posts by the same user |
556
+ | `post_external_link` | url | External link included in the post |
557
+ | `post_external_title` | text | Title of the external link |
558
+ | `post_external_image` | url | Post external link image |
559
+ | `header_image` | image | Header image of the Facebook page |
560
+ | `avatar_image_url` | text | The URL of the avatar image of the Facebook page |
561
+ | `profile_handle` | text | The handle or username of the Facebook page |
562
+ | `has_handshake` | text | Indicates if the post has a handshake |
563
+ | `is_sponsored` | boolean | Indicates whether the post is sponsored or not |
564
+ | `sponsor_name` | text | The name of the sponsor if the post is sponsored |
565
+ | `shortcode` | text | The shortcode of the post URL |
566
+ | `video_view_count` | number | The number of views if the post contains a video |
567
+ | `likes` | number | The number of likes on the post |
568
+ | `post_image` | image | post image url if exists |
569
+ | `post_type` | text | The type of the post |
570
+ | `following` | number | Number of profiles following |
571
+ | `price` | number | Price associated with the post |
572
+ | `location` | text | Location associated with the post |
573
+ | `profile_id` | text | Profile ID |
574
+ | `publisher_image_url` | url | Publisher image URL |
575
+ | `num_reaction_type` | array | Type of likes received (e.g., reactions, thumbs-up) |
576
+ | `delegate_page_id` | text | delegate_page_id |
577
+
578
+ </details>
579
+
580
+ <details>
581
+ <summary>All 38 post by URL fields, <code>gd_lyclm1571iy3mv57zw</code></summary>
582
+
583
+ | field | type | description |
584
+ | --- | --- | --- |
585
+ | `url` | url | URL |
586
+ | `post_id` | text | Unique identifier for each Facebook post |
587
+ | `user_url` | url | Unique identifier for each Facebook post |
588
+ | `user_username_raw` | text | Username of the user who posted the content |
589
+ | `content` | text | Text or media content of the post |
590
+ | `date_posted` | date | Date and time when the post was published |
591
+ | `hashtags` | array | Hashtags used in the post |
592
+ | `num_comments` | number | Number of comments on the post |
593
+ | `num_shares` | number | Number of shares of the post |
594
+ | `num_likes_type` | array | Type of likes received (e.g., reactions, thumbs-up) |
595
+ | `profile_id` | text | Unique identifier for the user's profile |
596
+ | `page_logo` | url | Logo of the Facebook page |
597
+ | `page_likes` | number | Number of likes on the Facebook page |
598
+ | `page_followers` | number | Number of followers of the Facebook page |
599
+ | `page_is_verified` | boolean | Verification status of the Facebook page |
600
+ | `original_post` | object | Indicates if the post is original or a repost |
601
+ | `attachments` | array | Attachments |
602
+ | `post_external_link` | url | External link included in the post |
603
+ | `post_external_title` | text | Title of the external link |
604
+ | `page_url` | url | Web address of the Facebook page |
605
+ | `header_image` | url | Header image of the Facebook page |
606
+ | `avatar_image_url` | text | The URL of the avatar image of the Facebook page |
607
+ | `profile_handle` | text | The handle or username of the Facebook page |
608
+ | `has_handshake` | text | Indicates if the post has a handshake |
609
+ | `is_sponsored` | boolean | Indicates whether the post is sponsored or not |
610
+ | `sponsor_name` | text | The name of the sponsor if the post is sponsored |
611
+ | `shortcode` | text | The shortcode of the post URL |
612
+ | `video_view_count` | number | The number of views if the post contains a video |
613
+ | `likes` | number | The number of likes on the post |
614
+ | `post_image` | url | post image url if exists |
615
+ | `post_type` | text | The type of the post |
616
+ | `user_handle` | text | User handle |
617
+ | `play_count` | number | Play count |
618
+ | `video_title` | text | Video title |
619
+ | `marketplace_price` | price | Price of the item from market place. This value is relevant for marketplace items that were shared in groups. |
620
+ | `delegate_page_id` | text | ID of the page delegated as “responsible for this Page” |
621
+ | `marketplace_is_sold` | text | Indicates whether the product has been sold, applicable only to marketplace posts |
622
+ | `comments` | array | Comments of the post |
623
+
624
+ </details>
625
+
626
+ <details>
627
+ <summary>All 22 comment fields, <code>gd_lkay758p1eanlolqw8</code></summary>
628
+
629
+ | field | type | description |
630
+ | --- | --- | --- |
631
+ | `url` | url | The URL of the page or post containing the comments |
632
+ | `post_id` | text | Unique identifier for each post |
633
+ | `post_url` | url | URL of the specific post |
634
+ | `comment_id` | text | Unique identifier for each comment |
635
+ | `user_name` | text | Name of the user who made the comment |
636
+ | `user_id` | text | Unique identifier for each user |
637
+ | `user_url` | url | URL of the user's profile |
638
+ | `date_created` | date | Date and time when the comment was created |
639
+ | `comment_text` | text | The actual text content of the comment |
640
+ | `num_likes` | number | Number of likes or reactions received by the comment |
641
+ | `num_replies` | number | Number of direct replies to the comment |
642
+ | `attached_files` | array | Any files or attachments associated with the comment |
643
+ | `video_length` | number | Length of video content, if applicable |
644
+ | `source_type` | text | Type of source (e.g., Facebook, external link) |
645
+ | `subtype` | text | Subcategory or specific type of the post or comment |
646
+ | `type` | text | General category of the post or comment |
647
+ | `commentator_profile` | url | Commentator profile |
648
+ | `comment_link` | url | Comment URL |
649
+ | `reply` | boolean | Reply |
650
+ | `parent_comment_id` | text | Parent comment id |
651
+ | `commentator_profile_url` | url | The URL of the profile picture of the commentator |
652
+ | `attached_images` | array | Any images associated with the comment |
653
+
654
+ </details>
655
+
656
+ <details>
657
+ <summary>All 27 reel fields, <code>gd_lyclm3ey2q6rww027t</code></summary>
658
+
659
+ | field | type | description |
660
+ | --- | --- | --- |
661
+ | `url` | url | URL of the reel |
662
+ | `post_id` | text | Unique identifier for each Facebook reel |
663
+ | `user_url` | url | Unique identifier for each Facebook reel |
664
+ | `user_username_raw` | text | Username of the user who posted the content |
665
+ | `content` | text | Text or media content of the reel |
666
+ | `date_posted` | date | Date and time when the reel was published |
667
+ | `hashtags` | array | Hashtags used in the reel |
668
+ | `num_comments` | number | Number of comments on the post |
669
+ | `num_shares` | number | Number of shares of the post |
670
+ | `video_view_count` | number | The number of views |
671
+ | `likes` | number | The number of likes on the reel |
672
+ | `page_name` | text | Name of the Facebook page where the reel was published |
673
+ | `profile_id` | text | Unique identifier for the user's profile |
674
+ | `page_logo` | url | URL of the Logo of the Facebook page |
675
+ | `page_likes` | number | Number of likes on the Facebook page |
676
+ | `page_followers` | number | Number of followers of the Facebook page |
677
+ | `page_is_verified` | boolean | Verification status of the Facebook page |
678
+ | `thumbnail` | url | URL of the reel thumbnail |
679
+ | `external_link` | url | External link included in the reel |
680
+ | `page_url` | url | Web address of the Facebook page |
681
+ | `header_image` | url | URL of the header image of the Facebook page |
682
+ | `avatar_image_url` | url | The URL of the avatar image of the Facebook page |
683
+ | `profile_handle` | text | The handle or username of the Facebook page |
684
+ | `shortcode` | text | The shortcode of the post URL |
685
+ | `length` | number | Length of the reel |
686
+ | `audio` | text | Audio of the reel |
687
+ | `video_url` | url | The Reel video URL |
688
+
689
+ </details>
690
+
691
+ <details>
692
+ <summary>All 28 page fields, <code>gd_mf124a0511bauquyow</code></summary>
693
+
694
+ | field | type | description |
695
+ | --- | --- | --- |
696
+ | `id` | text | Internal record ID |
697
+ | `url` | url | Facebook page URL |
698
+ | `page_name` | text | Page display name |
699
+ | `username` | text | Page handle (username) |
700
+ | `entity_type` | text | Page or Profile |
701
+ | `summary_text` | text | Intro tagline text |
702
+ | `primary_category` | text | Primary category |
703
+ | `work` | array | Employment lines |
704
+ | `education` | array | Education lines |
705
+ | `current_city` | text | Current city |
706
+ | `hometown` | text | Hometown |
707
+ | `relationship` | object | Relationship info |
708
+ | `address` | object | Business/location address |
709
+ | `phones` | array | Phone numbers |
710
+ | `emails` | array | Email addresses |
711
+ | `websites` | array | Websites and social links |
712
+ | `hours` | object | Opening hours |
713
+ | `rating` | object | Rating summary |
714
+ | `contact_and_basic_info` | object | About > Contact and basic info |
715
+ | `page_transparency` | object | About > Page transparency |
716
+ | `details_about` | object | About > Details About |
717
+ | `privacy_and_legal_info` | text | Privacy/terms/legal notes |
718
+ | `followers` | number | Number of followers |
719
+ | `logo` | url | The page logo |
720
+ | `is_verified` | boolean | Is the page verified |
721
+ | `group_members` | number | Number of members of the Facebook group (Applicable if the page is a group page) |
722
+ | `group_created_at` | date | The date When the group was created (Applicable if the page is a group page) |
723
+ | `num_posts_last_month` | number | Number of posts in the last month (Applicable if the page is a group page) |
724
+
725
+ </details>
726
+
727
+ <details>
728
+ <summary>All 11 profile fields, <code>gd_mf0urb782734ik94dz</code></summary>
729
+
730
+ | field | type | description |
731
+ | --- | --- | --- |
732
+ | `url` | url | URL |
733
+ | `name` | text | The name of the person |
734
+ | `id` | text | The Facebook profile ID |
735
+ | `profile_photo` | image | The profile photo |
736
+ | `cover_photo` | image | The profile's cover photo |
737
+ | `work` | array | The working places of the profile |
738
+ | `college` | array | College data of the profile |
739
+ | `high_school` | array | High school data of the profile |
740
+ | `photos` | array | The profile's photos |
741
+ | `location` | text | The location where the profile is from |
742
+ | `city` | text | The city where the profile is from |
743
+
744
+ </details>
745
+
746
+ <details>
747
+ <summary>All 18 review fields, <code>gd_m0dtqpiu1mbcyc2g86</code></summary>
748
+
749
+ | field | type | description |
750
+ | --- | --- | --- |
751
+ | `company_name` | text | The name of the company being reviewed. This field identifies which business the review is about, useful for categorizing and analyzing feedback by company. |
752
+ | `company_id` | text | A unique identifier for each company being reviewed. This field helps distinguish between different companies and allows for easy referencing and aggregation of reviews related to the same company |
753
+ | `company_url` | url | The URL of the reviewed company |
754
+ | `url` | url | The URL of the specific review on the Facebook platform. This link allows users to view the original review directly |
755
+ | `review_time` | date | The date and time when the review was posted. This helps in understanding the timeline and recency of the feedback |
756
+ | `recommends` | boolean | Indicates whether the reviewer recommends the company (true) or does not recommend it (false) |
757
+ | `review_content` | text | The textual content of the review, detailing the reviewer's experience and opinions about the company |
758
+ | `review_attachments` | array | An array of URLs pointing to any attachments included in the review, such as images or videos. These provide additional context or evidence related to the review |
759
+ | `number_of_reactions_to_review` | number | The total number of reactions (e.g., likes, loves, wows) that other Facebook users have given to the review. This indicates the level of engagement and visibility of the review |
760
+ | `review_reaction_types` | array | An array detailing the types of reactions (e.g., like, love, haha, wow, sad, angry) received by the review. This helps to understand the emotional response of the audience to the review. |
761
+ | `reviewer_profile_url` | url | The URL of the reviewer's Facebook profile. This link allows access to the reviewer's profile for further context |
762
+ | `reviewer_name` | text | reviewer_name |
763
+ | `reviewer_profile_picture_url` | url | reviewer_profile_picture_url |
764
+ | `recommended_perc` | text | The percentage of recommended reviews |
765
+ | `likes` | number | The amount of likes the page has |
766
+ | `followers` | number | The amount of followers the page has |
767
+ | `total_reviews` | number | The total number of reviews |
768
+ | `replies` | array | replies |
769
+
770
+ </details>
771
+
772
+ <details>
773
+ <summary>All 23 Marketplace listing fields, <code>gd_lvt9iwuh6fbcwmx1a</code></summary>
774
+
775
+ | field | type | description |
776
+ | --- | --- | --- |
777
+ | `url` | url | The direct URL of the Facebook Marketplace listing page |
778
+ | `title` | text | The title of the listing as posted by the seller |
779
+ | `initial_price` | number | The original listed price of the item before any discounts |
780
+ | `final_price` | number | The current or discounted price of the item |
781
+ | `currency` | text | The currency in which the price is listed |
782
+ | `product_id` | text | The unique identifier assigned to the listing by Facebook Marketplace. |
783
+ | `breadcrumbs` | array | A list of navigation breadcrumb items representing the category hierarchy of the listing |
784
+ | `condition` | text | The condition of the listed item as reported by the seller |
785
+ | `description` | text | The full textual description of the listing, as written by the seller |
786
+ | `location` | text | The general location |
787
+ | `country_code` | text | The two-letter ISO 3166-1 alpha-2 country code |
788
+ | `root_category` | text | The root category the listing belongs to on Facebook Marketplace |
789
+ | `images` | array | A list of URLs pointing to the listing's product images uploaded by the seller |
790
+ | `seller_description` | text | A short bio or description from the seller's Facebook Marketplace profile |
791
+ | `color` | text | The color of the listed item, if applicable and provided by the seller |
792
+ | `brand` | text | The brand or manufacturer of the listed item, if applicable |
793
+ | `videos` | array | A list of URLs pointing to any video content uploaded by the seller as part of the listing |
794
+ | `profile_id` | text | The unique Facebook profile ID of the seller who posted the listing |
795
+ | `listing_date` | date | The date and time when the listing was originally posted on Facebook Marketplace |
796
+ | `car_miles` | number | The mileage of the vehicle as reported by the seller. Only relevant for car/vehicle listings |
797
+ | `is_sold` | boolean | Indicates whether the product is sold |
798
+ | `transmission` | text | Transmission type shown in vehicle details. Only relevant for car/vehicle listings |
799
+ | `vehicle_details` | object | Detailed vehicle-specific attributes extracted from the 'About this vehicle' section of Facebook Marketplace car listings. Null for non-vehicle listings. |
800
+
801
+ </details>
802
+
803
+ <details>
804
+ <summary>All 30 event fields, <code>gd_m14sd0to1jz48ppm51</code></summary>
805
+
806
+ | field | type | description |
807
+ | --- | --- | --- |
808
+ | `event_id` | text | Unique identifier for the event |
809
+ | `url` | url | Direct URL link to the event |
810
+ | `main_image` | url | URL for the primary image of the event |
811
+ | `event_date` | date | Date of the event |
812
+ | `title` | text | Name or title of the event |
813
+ | `people_responded` | number | Number of people marked as "responded" to the event |
814
+ | `event_by` | array | Array of objects specifying the event organizer(s), with name and URL fields for each |
815
+ | `location` | object | Nested object containing address and URL |
816
+ | `access_level` | array | Indicates the privacy or access level of the event (e.g., public, private) |
817
+ | `description` | object | Object with text, links, and hashtags fields for detailed event descriptions |
818
+ | `hashtags` | array | Separate from description, this is an array that provides general hashtags associated with the event |
819
+ | `hosts` | array | Array of objects to specify event hosts, including name, URL, and verification status |
820
+ | `suggested_events` | array | Array listing other recommended or similar events, with each having fields for name, URL, date, people interested, and location |
821
+ | `tickets` | object | Object detailing ticket information, including the URL, provider, min/max prices, and currency |
822
+ | `duration` | object | Object defining the event's duration |
823
+ | `main_image_downloadable` | url | Main image downloadable |
824
+ | `responded_object` | object | Responded object |
825
+ | `event_start_time` | date | Start time of the event |
826
+ | `event_end_time` | date | End time of event |
827
+ | `event_end_date` | date | End Data of event in case the event is longer than a day |
828
+ | `full_address` | text | Address of the event |
829
+ | `longitude` | text | Longitude |
830
+ | `latitude` | text | Latitude |
831
+ | `event_timezone` | text | Timezone of the event |
832
+ | `unformatted_description_text` | text | The description text with its original structure |
833
+ | `alternative_dates` | array | Alternative dates |
834
+ | `alternative_date_time` | array | Alternative date time |
835
+ | `redirected_event_url` | url | Redirected event URL |
836
+ | `main_video` | url | main video if available |
837
+ | `is_cancelled` | boolean | Indicates whether the event is cancelled |
838
+
839
+ </details>
840
+
841
+ <details>
842
+ <summary>All 32 Ad Library ad fields, <code>gd_mtveskb62h7q65ftgz</code></summary>
843
+
844
+ | field | type | description |
845
+ | --- | --- | --- |
846
+ | `url` | url | Meta Ad Library ad detail page URL |
847
+ | `library_id` | text | Unique Meta Ad Library ID (kept as text, exceeds safe integer range) |
848
+ | `is_active` | boolean | Indicates if the ad is currently running |
849
+ | `status` | text | Ad status label (Active, Inactive) |
850
+ | `start_date` | date | Date the ad started running |
851
+ | `end_date` | date | Date the ad stopped running (empty while active) |
852
+ | `total_active_time` | text | Total active time as displayed (e.g., 8 hrs) |
853
+ | `ad_category` | text | Special ad category (Housing, Employment, Credit, Social issues, elections or politics); empty for commercial ads |
854
+ | `has_multiple_versions` | boolean | Indicates if the ad has multiple creative versions |
855
+ | `versions_count` | number | Number of creative versions (from the 1 of N indicator) |
856
+ | `creative_reuse_count` | number | Number of ads using this creative and text |
857
+ | `platforms` | array | Platforms the ad is delivered on |
858
+ | `platforms_count` | number | Number of platforms the ad runs on |
859
+ | `description` | text | Primary ad body text |
860
+ | `title` | text | Ad headline |
861
+ | `link_description` | text | Link description shown below the headline |
862
+ | `caption` | text | Display domain shown above the headline (e.g., ADIDAS.EU) |
863
+ | `cta_text` | text | Call to action button text as displayed (e.g., Shop Now) |
864
+ | `cta_type` | text | Normalized call to action type (e.g., SHOP_NOW, LEARN_MORE, SIGN_UP) |
865
+ | `link_url` | url | Destination URL of the ad |
866
+ | `image_url` | url | Main creative image URL |
867
+ | `video_url` | url | Main creative video URL |
868
+ | `video_preview_image` | url | Video thumbnail image URL |
869
+ | `ad_versions` | array | All creative versions or carousel cards of the ad |
870
+ | `advertiser_name` | text | Advertiser name from the About the advertiser section |
871
+ | `advertiser_profile_picture` | url | Advertiser profile picture URL |
872
+ | `advertiser_description` | text | Advertiser More info description text |
873
+ | `advertiser_social_accounts` | array | Advertiser social accounts listed in the About the advertiser section |
874
+ | `advertiser_and_payer` | array | Advertiser and payer entries (EU and associated territories only) |
875
+ | `eu_total_reach` | number | Total reach of the ad in the European Union |
876
+ | `transparency_by_location` | array | Reach and targeting details per location (EU and associated territories only) |
877
+ | `is_eu_ad` | boolean | Indicates if the ad is delivered in the EU and carries DSA transparency sections |
878
+
879
+ </details>
880
+ <!-- fields:end -->
881
+
882
+ <details>
883
+ <summary>The start of a real output file, from <code>facebook-scraper Meta --limit 1</code></summary>
884
+
885
+ ```json
886
+ {
887
+ "generated_at": "2026-11-03T19:25:27.615005+00:00",
888
+ "pages": [
889
+ {
890
+ "page": "Meta",
891
+ "posts": [
892
+ {
893
+ "url": "https://www.facebook.com/Meta/posts/pfbid0evGHWPACd3JninWg3j3nucQjdFxoHWwJSPgFXKjZXaUiU8MctREDPRZZsAps6CGwl",
894
+ "post_id": "1181668677855674",
895
+ "user_url": "https://www.facebook.com/Meta",
896
+ "user_username_raw": "Meta",
897
+ "content": "Meta Ray-Ban Display has been out for a while, so if you’re a developer, this one’s for you.\n\nbuild a game, a productivity tool, a science app — really, anything you love — and watch it run on an in-lens display, controlled by the Meta Neural Band.\n\nneed inspo? here’s what people have already cooked up: \n\nMeta Geology by @inna.sparrow.xr\nVistathlon by @stspanho\nSee DJ by @levinriegner\nSightline by @fasai.creates",
898
+ "date_posted": "2026-10-30T19:41:31.000Z",
899
+ "num_comments": 343,
900
+ "num_shares": 194,
901
+ "num_likes_type": {
902
+ "type": "Like",
903
+ "num": 593
904
+ },
905
+ "page_name": "Meta",
906
+ ...
907
+ ```
908
+
909
+ The whole file, one post with every field, is
910
+ [examples/sample_output.json](https://github.com/brightdata/facebook-scraper/blob/main/examples/sample_output.json).
911
+
912
+ </details>
913
+
914
+ ## Facebook scraper errors
915
+
916
+ | you see | what it means |
917
+ | --- | --- |
918
+ | `API token required but not found.` | Exit 2, before any request. Set the token, or run `bdata login`. |
919
+ | `failed page: Posts not found` | Exit 1. No such page, a private one, or a page with no public posts. Check the name. |
920
+ | `failed page: timeout: snapshot ... not ready after 900s` | Exit 1. Run it again, or fetch the snapshot later with `fetch()`. |
921
+ | `failed page: HTTP 401: ...` | The token is set but wrong. |
922
+
923
+ Any failure exits 1, so a run is safe to gate a script on.
924
+
925
+ From the functions, the same conditions look like this:
926
+
927
+ | you see | what it means |
928
+ | --- | --- |
929
+ | `TokenMissing` | No `BRIGHTDATA_API_TOKEN` and no `bdata login`. |
930
+ | `ApiError: HTTP 400: ...validation_error...` | An input field the API does not accept. The message names it; compare with the table above. |
931
+ | a row with an `error` key | The API's answer for one input: "Posts not found", a dead page, "Reviews not found", "There are no events." The other rows are fine. |
932
+ | `TimeoutError` | The job outlived the 900-second wait. Pass `timeout=` to `run`, or use `trigger` and fetch later. |
933
+
934
+ ## Facebook MCP server and Claude Code skill
935
+
936
+ No Python, nothing installed. Paste both lines; the first opens a browser
937
+ once, or use `bdata login --device` over SSH and in CI:
938
+
939
+ ```bash
940
+ npx -p @brightdata/cli bdata login
941
+ npx -p @brightdata/cli bdata pipelines run gd_lkaxegm826bjpoo9m5 collect_by_url --url "https://www.facebook.com/Meta" --num_of_posts 2 --pretty
942
+ ```
943
+
944
+ 2 records, up to 38 fields, 74 seconds on 3 Nov 2026. The CLI leaves out
945
+ fields that are null.
946
+
947
+ The CLI runs a scraper by its dataset ID, every Facebook one included.
948
+ `bdata pipelines search facebook` lists their IDs and methods, and
949
+ `--limit-per-input N` caps a discovery, 10 by default.
950
+
951
+ `npx skills add brightdata/skills` teaches Claude Code, Cursor and Codex these
952
+ commands and the docs, so plain language works afterwards. Full guide:
953
+ [Bright Data for your coding agent](https://docs.brightdata.com/quickstart-coding-agent).
954
+
955
+ No terminal, for a hosted assistant? The
956
+ [Bright Data MCP server](https://github.com/brightdata/brightdata-mcp#which-tool-to-use)
957
+ runs any pre-built scraper, Facebook included, through `search_scrapers` and
958
+ `run_scraper` in its `scrapers` group:
959
+
960
+ https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&groups=scrapers
961
+
962
+ An agent can also open the account itself, no signup form:
963
+ [agent registration](https://brightdata.com/auth.md). Everything else Bright
964
+ Data connects to, from LangChain to Zapier and n8n:
965
+ [integrations](https://docs.brightdata.com/integrations/introduction).
966
+
967
+ ## Is this Facebook scraper free?
968
+
969
+ New Bright Data accounts get
970
+ [5,000 free credits a month](https://docs.brightdata.com/general/account/billing-and-pricing/free-tier).
971
+ Every Facebook scraper bills per record: per post, comment, reel, page,
972
+ profile, review, listing, event or ad.
973
+ [Pricing](https://brightdata.com/pricing/web-scraper) lists the rates.
974
+
975
+ ## Support
976
+
977
+ Bugs in this repo:
978
+ [open an issue](https://github.com/brightdata/facebook-scraper/issues), and
979
+ [CONTRIBUTING.md](https://github.com/brightdata/facebook-scraper/blob/main/CONTRIBUTING.md) says what to put in it.
980
+ Anything about the API, your account or your credits:
981
+ [Bright Data support](https://brightdata.zendesk.com/hc/en-us/requests/new).
982
+
983
+ ## License
984
+
985
+ [Apache 2.0](https://github.com/brightdata/facebook-scraper/blob/main/LICENSE).
986
+
987
+ ## Facebook scraper for Node.js
988
+
989
+ The same Facebook scraper is available for Node.js: [brightdata/facebook-scraper-node](https://github.com/brightdata/facebook-scraper-node).
990
+
991
+ ## More open source scrapers from Bright Data
992
+
993
+ Other Python scrapers built the same way, with live-verified examples:
994
+
995
+ - [Instagram scraper for Python](https://github.com/brightdata/instagram-scraper)
996
+ - [TikTok scraper for Python](https://github.com/brightdata/tiktok-scraper)
997
+ - [LinkedIn scraper for Python](https://github.com/brightdata/linkedin-scraper)