---
title: "Group"
method: GET
path: "/v1/facebook/group"
tags: ["facebook"]
---

# Group

`GET /v1/facebook/group`

## Request

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

Returns a Facebook group's public record: name, description, member count, privacy, visibility, and creation date.

Use it to identify a group by URL or group_id before calling group/posts for the recent posts.

**10 credits** per call.

## Query parameters

- `url` string
- `group_id` string
- `dry_run` '1'

## Response `200`

Success.

- object
  - `success` true, required
  - `platform` string, required
  - `endpoint` string, required
  - `schema_version` '2', required
  - `data` ProfileOne, 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.
  - `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)