---
title: "Search › Groups"
method: GET
path: "/v1/facebook/search/groups"
tags: ["facebook"]
---

# Search › Groups

`GET /v1/facebook/search/groups`

## Request

- Base URL: `https://api.insightsocial.app`
- URL: `https://api.insightsocial.app/v1/facebook/search/groups`
- Auth: API key in header `x-api-key`

Returns public Facebook groups matching your keywords, one row per group, with the group's name, id and URL in the same shape the group endpoints take.

Use it when you need to find the groups to read before pulling their posts. Add include=details for member counts, descriptions and privacy.

**Metered: 10–110 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by `cursor`: see [Pagination](https://www.insightsocial.app/docs/pagination).

## Query parameters

- `query` string, required
- `page` integer
- `include` 'details'
- `dry_run` '1'
- `cursor` string

## Response `200`

Success.

- object
  - `success` true, required
  - `platform` string, required
  - `endpoint` string, required
  - `schema_version` '2', required
  - `data` ProfilePage, required
    - `items` object[], required
      - `author` Profile, required
        - `id` string, required: An identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
        - `username` string, nullable, required
        - `display_name` string, nullable, required
        - `avatar_url` string, uri, nullable, required
        - `bio` string, nullable, required
        - `verified` boolean, nullable, required
        - `followers` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `followers_approximate` boolean, nullable, required
        - `following` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `posts_count` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `likes_count` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `url` string, uri, nullable, required
        - `location` string, nullable, required
        - `external_url` string, uri, nullable, required
        - `private` boolean, nullable, required
        - `joined_at` string, date-time, nullable, required: ISO-8601 timestamp in UTC, ending in Z.
        - `last_post_at` string, date-time, nullable, required: ISO-8601 timestamp in UTC, ending in Z.
        - `ext` object, nullable, required: Platform-specific fields, snake_case. The key list per platform is in the docs.
    - `total` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
    - `truncated` boolean, nullable, required
    - `ext` object, nullable: Platform-specific fields, snake_case. The key list per platform is in the docs.
  - `pagination` Pagination
    - `next_cursor` string, nullable, required
    - `has_more` boolean, required
    - `page_size` integer, required
    - `stopped_at` 'since' | 'known_id' | 'end', nullable
  - `unavailable` string[], required
  - `credits_used` integer, required
  - `credits_remaining` integer, required
  - `request_id` string, required
  - `cached` boolean, required
  - `idempotent_replay` boolean, required
  - `charge_reason` string, required
  - `free_call` boolean, required

## Other responses

- `400`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `401`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `402`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `404`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `409`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `429`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `500`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `503`: See [Error handling](https://www.insightsocial.app/docs/errors).

---

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