# Facebook Group posts API (facebook.group_posts)

- Canonical page: https://everyinfra.com/en/facebook-api/group_posts
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "facebook", "action": "group_posts", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=facebook&action=group_posts

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions. |
| sort | not declared | no | not declared | Specifies post ordering for group_posts using top for top posts or recent for posts with recent activity, defaulting to chronological order if omitted. The recent option is based on activity rather than post creation time alone. Unsupported string values fall back to chronological order instead of returning an error. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| share_count | Shares. null means not disclosed, not 0. |
| author_id | Numeric user id of the comment author (stable identifier for cross-request deduplication). |
| author_name | Author's display name. |
| author_url | Profile link of the comment author. |
| group_url | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "facebook",
  "action": "group_posts",
  "params": {
    "url": "https://www.facebook.com/groups/874728723021553"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "facebook",
        "action": "group_posts",
        "params": {
            "url": "https://www.facebook.com/groups/874728723021553",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "facebook",
  "action": "group_posts",
  "results": [
    {
      "id": "UzpfSTEwMDA2NDM5NjI4NTkyMTpWSzoyNjIwNDE3NTU4NDUyNjUy",
      "url": "https://www.facebook.com/groups/874728723021553/permalink/2620417558452652/",
      "text": "Let's welcome our new members!\nAkira Zy Marcelo,\nAnatu Anaaf Anaaf,\nพิมพ์ชนก ทองจำปา,\nSimple Gel,\nCharlotte Badilla,\nSidra Kanwal,\nAlthea Zhana Lambot,\nLeslie Vinluan,\nAbdulraffy Jang Woo,\nValdez July,\nJomary Agacer,\nRon Jacob Buenaobra,\nDeane Milne,\nIyasuu Baatii Bati,\nLagnason …",
      "posted_at": "2026-09-26T08:32:01+00:00",
      "like_count": 0,
      "comment_count": 0,
      "share_count": 0,
      "author_id": "•••",
      "author_name": "•••",
      "group_url": "https://www.facebook.com/groups/874728723021553",
      "platform": "facebook"
    },
    {
      "id": "UzpfSTEwMDA2NDM5NjI4NTkyMTpWSzoyNjE5OTU5NjMxODMxNzc4",
      "url": "https://www.facebook.com/groups/874728723021553/permalink/2619959631831778/",
      "text": "Let's welcome our new members!\nSylvain Zeh,\nMesayAbebe Mesay,\nNeii Esther Rere Brechtefeld,\nMälãk Chöùràbï,\nYusuf Nyundo,\nGabriela Santos,\nOnyx Orchid,\nMar Biya,\nRouane Kako,\nEyosiyas Silesh Eyos,\nMoez Benboubaker,\nKabeer S Ahmad,\nDadou Dadou Grigrios,\nPrasetha S-k,\nGatwech Tharj…",
      "posted_at": "2026-09-25T20:31:59+00:00",
      "like_count": 2,
      "comment_count": 1,
      "share_count": 0,
      "author_id": "•••",
      "author_name": "•••",
      "group_url": "https://www.facebook.com/groups/874728723021553",
      "platform": "facebook"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=facebook
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md