> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a public Facebook group's posts > Fetches a public Facebook group's discussion posts (logged-out — only the posts visible in an incognito session). Pass `url` OR `groupId` (the numeric group id — faster, it skips resolving the url). Each post includes text, author (the member who posted), media (photos/video), a shared-link preview, timestamp, and engagement stats (reactions with a per-type breakdown, comments, shares). Returns a `paging.cursor` / `paging.hasNextPage` for the next page. Use `sortBy` to change the ordering (default CHRONOLOGICAL). ## OpenAPI ````yaml /api-reference/openapi.json get /v1/facebook/group/posts openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: Google description: Google Search scraping endpoints paths: /v1/facebook/group/posts: get: tags: - Facebook summary: Get a public Facebook group's posts description: >- Fetches a public Facebook group's discussion posts (logged-out — only the posts visible in an incognito session). Pass `url` OR `groupId` (the numeric group id — faster, it skips resolving the url). Each post includes text, author (the member who posted), media (photos/video), a shared-link preview, timestamp, and engagement stats (reactions with a per-type breakdown, comments, shares). Returns a `paging.cursor` / `paging.hasNextPage` for the next page. Use `sortBy` to change the ordering (default CHRONOLOGICAL). parameters: - name: url in: query required: false description: >- **Required — provide one of `url` or `groupId`.** Public Facebook group URL, e.g. https://www.facebook.com/groups/cristianoronaldo404. schema: type: string example: https://www.facebook.com/groups/cristianoronaldo404 - name: groupId in: query required: false description: >- **Required — provide one of `url` or `groupId`.** Numeric group id (faster than url). schema: type: string example: '367172990112802' - name: cursor in: query required: false description: The `paging.cursor` from a previous call, to fetch the next page. schema: type: string - name: sortBy in: query required: false description: >- Feed ordering (default `CHRONOLOGICAL`). `CHRONOLOGICAL` = newest first; `TOP_POSTS` = Facebook's "Most relevant"; `RECENT_ACTIVITY` = most recent activity first; `CHRONOLOGICAL_LISTINGS` = newest buy/sell listings (only groups with marketplace listings return anything). Case-insensitive; spaces are accepted (e.g. "recent activity"). schema: type: string enum: - CHRONOLOGICAL - TOP_POSTS - RECENT_ACTIVITY - CHRONOLOGICAL_LISTINGS default: CHRONOLOGICAL - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The group posts. content: application/json: schema: type: object properties: data: type: object properties: posts: type: array items: type: object postCount: type: integer paging: type: object properties: cursor: type: string nullable: true hasNextPage: type: boolean fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: posts: - postId: '3516531235176946' storyId: UzpfSTEwMDA5MDM0ODgxMjU5OTpWSzozNTE2NTMxMjM1MTc2OTQ2 url: >- https://www.facebook.com/groups/cristianoronaldo404/posts/3516531235176946/ text: >- Easy DIY Tool Hack 😮 #DIY #WorkshopHacks #DIYTools #ToolTips #USA author: name: Alice Angel id: '100090348812599' url: >- https://www.facebook.com/people/Alice-Angel/100090348812599/ avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/503737997_680208598334095_3767475048790493201_n.jpg?stp=c0.270.1080.1080a_cp0_dst-jpg_tt6&cstp=mx1080x1080&ctp=s40x40&_nc_cat=111&ccb=1-7&_nc_sid=1d2534&_nc_ohc=xeVt9-qBSdgQ7kNvwHUN3ed&_nc_oc=AdoKVyHqnjBtrom1KxEmWMKxbW93VSsYH5MMbNkHXopiWgzeBD6_rguHdrZN_RKTnPA&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&oh=00_AQIR4CLUas5cUU1lZz653_8rGWd1AzmMU7C-jZN0QizTWQ&oe=6AADAD3A verified: null createdAt: '2026-08-31T17:54:52.000Z' createdTimestamp: 1788198892 media: type: video videoId: '2332244467596542' videoUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQMpowAj8kbVPvfLLnTGpi8v2K0Wtq-3EmilGrWtT0-hiWbOPXUvkz7-aA1DPf67VLlf9mBarzEYT__IGBWBVXzsmHU0gwr98HZ4qRQqp3KhMg.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=Tee8c-aKS8YQ7kNvwHFW_ve&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjEwNTIxMTI4OTA5NTIxMzMsImFzc2V0X2FnZV9kYXlzIjoyNSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjI5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=a5acb8e1ba8ba118&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC8xRjQ4OEI4OUIxQzMwRUY5NEZEMjFGNDYwQjg0NjQ4MF9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzA5NDBENEM0MEY2NkJGQUI3QTJGQTM4MDFGRTVBNjg3X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaK54fyg7neAxUCKAJDMywXQD1VP3ztkWgYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&_nc_zt=28&oh=00_AQJWJT7CuvM0TLD-vhKc5acGZH3AnqoLL8BPToclvdHzMQ&oe=6AAD9BFF&bitrate=1634821&tag=dash_h264-basic-gen2_720p videoHdUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQMpowAj8kbVPvfLLnTGpi8v2K0Wtq-3EmilGrWtT0-hiWbOPXUvkz7-aA1DPf67VLlf9mBarzEYT__IGBWBVXzsmHU0gwr98HZ4qRQqp3KhMg.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=Tee8c-aKS8YQ7kNvwHFW_ve&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjEwNTIxMTI4OTA5NTIxMzMsImFzc2V0X2FnZV9kYXlzIjoyNSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjI5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=a5acb8e1ba8ba118&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC8xRjQ4OEI4OUIxQzMwRUY5NEZEMjFGNDYwQjg0NjQ4MF9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzA5NDBENEM0MEY2NkJGQUI3QTJGQTM4MDFGRTVBNjg3X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaK54fyg7neAxUCKAJDMywXQD1VP3ztkWgYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&_nc_zt=28&oh=00_AQJWJT7CuvM0TLD-vhKc5acGZH3AnqoLL8BPToclvdHzMQ&oe=6AAD9BFF&bitrate=1634821&tag=dash_h264-basic-gen2_720p videoSdUrl: >- https://video-los4-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQNFTvOwg0PRi5yJoY6STCthra-mYmiHcbOYEsDhCd8lVOKTrvINyHP9oRq2G77HTzKRP0-pEVwvSA9nLaTiH5Pj8o-lY4ZA3-cEojlC9w.mp4?_nc_cat=109&_nc_sid=8bf8fe&_nc_ht=video-los4-1.xx.fbcdn.net&_nc_ohc=-nzdtioIflIQ7kNvwF7IW2m&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTA1MjExMjg5MDk1MjEzMywiYXNzZXRfYWdlX2RheXMiOjI1LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MjksInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&_nc_zt=28&oh=00_AQJx4pUSTiFmeAWB5O_z4WxZyRKQbZlLwVtI3h6jK0_ZAg&oe=6AADCD19&bitrate=397164&tag=sve_sd thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t15.5256-10/777800040_27464747536561006_509832802318622594_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=s960x960&_nc_cat=104&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=bRTdN2mOUAMQ7kNvwEz3qhj&_nc_oc=AdpdMxQWzXKg1S6Q8xfkfAiP5CkNPlBJCbdpJ1aFUyBHRFdrOtvCcYFLnevTn04Zk8Q&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&oh=00_AQI6HvFKd6o6M3QlpHtuI0Mql1yHp3Bb1XVWpp_YTubn3w&oe=6AADCC91 width: 1080 height: 1920 durationSeconds: 29 images: [] music: null link: null stats: reactions: 0 reactionsByType: [] comments: 0 shares: 0 views: null viewsLabel: null topComments: [] isReshare: true sharedPost: text: null author: name: null id: null url: null avatarUrl: null verified: null url: https://www.facebook.com/reel/2332244467596542/ - postId: '3349239175239487' storyId: UzpfSTEwMDA5MTgyNzAyNTA5MzpWSzozMzQ5MjM5MTc1MjM5NDg3 url: >- https://www.facebook.com/groups/cristianoronaldo404/posts/3349239175239487/ text: null author: name: Raju Mondal id: >- pfbid0ZHG5EqdDqHyKQZSWcA67uYTnx5s8u1AgawLSrKTjVUUZwULAFUGX15QNEXSjBYgnl url: >- https://www.facebook.com/people/Raju-Mondal/pfbid0ZHG5EqdDqHyKQZSWcA67uYTnx5s8u1AgawLSrKTjVUUZwULAFUGX15QNEXSjBYgnl/ avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/343453846_194757432910266_3101380573593260046_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx505x505&ctp=s40x40&_nc_cat=109&ccb=1-7&_nc_sid=e99d92&_nc_ohc=6gxTwUFRIAUQ7kNvwGOuREh&_nc_oc=AdpznNbVpRYFzD7S7AmNOvmR_rHOaxOnbRWw2j2qkxmB_edUuWUxEIMoGipJF4klFyQ&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&oh=00_AQLcBFcLkxkUQAY7i3o-3MPHSUU7h5RUNTr_Va7ELvXJzw&oe=6AADC6C4 verified: null createdAt: '2026-03-31T17:19:16.000Z' createdTimestamp: 1774977556 media: type: null videoId: null videoUrl: null videoHdUrl: null videoSdUrl: null thumbnailUrl: null width: null height: null durationSeconds: null images: [] music: null link: null stats: reactions: 6 reactionsByType: - type: Like count: 6 - type: Love count: 0 - type: Care count: 0 comments: 0 shares: 0 views: null viewsLabel: null topComments: [] isReshare: false sharedPost: null - postId: '3202741759889230' storyId: UzpfSTEwMDA0MjQyNzY0MDc0NDpWSzozMjAyNzQxNzU5ODg5MjMw url: >- https://www.facebook.com/groups/cristianoronaldo404/posts/3202741759889230/ text: >- Goals scored since Cristiano's 2nd United debut (so far): Rashford: 50 goals in 154 games Bruno Fernandes: 48 goals in 189 games Cristiano: 27 goals in 54 games Garnacho: 23 goals in 126 games Hojlund: 23 goals in 78 games Cristiano joined Al Nassr in January 2023. 🤯 author: name: Mam Kania Tudiroh id: '100042427640744' url: https://www.facebook.com/Tudiroh avatarUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-1/669297920_1684128233011415_7889713644786062292_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1280x1280&ctp=s40x40&_nc_cat=100&ccb=1-7&_nc_sid=1d2534&_nc_ohc=Crm8-imraO4Q7kNvwF3i31I&_nc_oc=AdqEraDHqLdhjwpm9BNSlkzqBeRpVBKh93Fi4TI9tWqARfiiJF_UXmLf8C3NVJK_cs4&_nc_zt=24&_nc_ht=scontent-los4-1.xx&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&oh=00_AQJcRhYlMY3MWtfIsN8uEI-BzTazr8aGVkunXkk2R5d1Ag&oe=6AADC726 verified: null createdAt: '2025-11-10T10:45:52.000Z' createdTimestamp: 1762771552 media: type: photo videoId: null videoUrl: null videoHdUrl: null videoSdUrl: null thumbnailUrl: >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/580499657_1559955022095404_3958095944604037543_n.jpg?stp=dst-jpg_tt6&cstp=mx720x878&ctp=s640x640&_nc_cat=111&ccb=1-7&_nc_sid=aa7b47&_nc_ohc=zbnuSx3dPw4Q7kNvwFUwv7F&_nc_oc=AdrAlsVInLc1Zi-uVDdqEBtFdTsYx0NR1Fpnf5ngaeeLO_dSMNh53KnaGC9i5jdk4TQ&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&oh=00_AQIMxiTGnnM4lHqg8ZKFVIbdm1XAYjC5ao-5AS8gdc6FuQ&oe=6AADA199 width: null height: null durationSeconds: null images: - >- https://scontent-los4-1.xx.fbcdn.net/v/t39.30808-6/580499657_1559955022095404_3958095944604037543_n.jpg?stp=dst-jpg_tt6&cstp=mx720x878&ctp=s640x640&_nc_cat=111&ccb=1-7&_nc_sid=aa7b47&_nc_ohc=zbnuSx3dPw4Q7kNvwFUwv7F&_nc_oc=AdrAlsVInLc1Zi-uVDdqEBtFdTsYx0NR1Fpnf5ngaeeLO_dSMNh53KnaGC9i5jdk4TQ&_nc_zt=23&_nc_ht=scontent-los4-1.xx&_nc_gid=S_jBd96b0BCJqk4RQfQUYg&_nc_ss=7f289&oh=00_AQIMxiTGnnM4lHqg8ZKFVIbdm1XAYjC5ao-5AS8gdc6FuQ&oe=6AADA199 music: null link: null stats: reactions: 144 reactionsByType: - type: Like count: 120 - type: Love count: 20 - type: Care count: 4 comments: 0 shares: 0 views: null viewsLabel: null topComments: [] isReshare: false sharedPost: null postCount: 3 paging: cursor: >- Cg8TZXhpc3RpbmdfdW5pdF9jb3VudAIEDwtyZWFsX2N1cnNvcg+fQVFIVGdMYVk3T3Z4VVVRTTV6YkFXLW5XS3dUWXh6cnhyeFFUMC1zYm9qc2RXZmpPUzN5QTdfeGhFVXAtZmo5YTExaW1mYUhEYU1TbFBaODBzcnNsLTAyNk1ROmV5SXdJam94TnpnNU16ZzRNRFUwTENJeElqbzNOamd5TENJeklqb3dMQ0kwSWpveExDSTFJam8wTENJMklqb3RNWDA9DxNoZWFkZXJfZ2xvYmFsX2NvdW50AgEPEm1haW5fZmVlZF9wb3NpdGlvbgIEDw1mZWVkX29yZGVyaW5nDw1hdHRhY2hlZF90aW1lDxNpc19ldmVyZ3JlZW5fY3Vyc29yEQAPImlzX29mZmxpbmVfYWdncmVnYXRlZF9wb3N0c19jdXJzb3IRAA8SZ3JvdXBfZmVlZF92ZXJzaW9uDwJWMg8QZGVtb3RlZF9wb3N0X2lkcwoBAQ== hasNextPage: true fetchedAt: '2026-09-14T12:14:15.990Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '400': description: Invalid or expired cursor. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: BAD_REQUEST message: The request was invalid. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Group not found / no public posts. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (missing url and groupId). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '502': description: Upstream block. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source was temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ````