---
title: "Search Facebook Group Posts"
method: GET
path: "/v1/facebook/group/search"
tags: ["Facebook"]
---

# Search Facebook Group Posts

`GET /v1/facebook/group/search`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/facebook/group/search`
- Auth: API key in header `X-API-Key`

Temporarily unavailable: this endpoint is offline while we upgrade it, and every request currently returns 503 with "code": "endpoint_suspended". The rest of this reference describes the endpoint as it behaves when available. Search for posts within a specific Facebook group by keyword. Supports date filtering.

**Price:** $0.008 per page. **Free tier:** 50 requests/month.

## Query parameters

- `query` string, required
- `group_id` string, required
- `pages` integer
- `start_date` string
- `end_date` string
- `get_sentiment` boolean

## Response `200`

Successful response

- FacebookGroupSearchResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `count` number, nullable
  - `pages` number, nullable
  - `posts` object[], nullable
    - `author_id` string, nullable
    - `author_name` string, nullable
    - `author_profile_picture` string, nullable
    - `author_url` string, nullable
    - `comments_count` number, nullable
    - `date` string, nullable
    - `external_url` unknown
    - `image_url` string, nullable
    - `message` string, nullable
    - `post_id` string, nullable
    - `reactions` object, nullable
      - `angry` number, nullable
      - `care` number, nullable
      - `haha` number, nullable
      - `like` number, nullable
      - `love` number, nullable
      - `sad` number, nullable
      - `wow` number, nullable
    - `reactions_count` number, nullable
    - `reshare_count` number, nullable
    - `timestamp` number, nullable
    - `url` string, nullable
    - `video` unknown

## Other responses

- `400`: Bad request: missing or invalid parameter
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `429`: Rate limit exceeded, or more than 10 concurrent requests to this endpoint
- `500`: Internal server error
- `502`: Temporary failure retrieving Facebook data. Please retry shortly.
- `503`: Endpoint temporarily unavailable while we upgrade it ("code": "endpoint_suspended"). Every request currently returns this.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)