> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapti.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Content Group Items By Content Group ID

> Retrieves all individual items within a specific content group. This tool provides access to the detailed information about each component in a multi-media content collection such as carousel posts, albums, or playlists.

<Info>
  This tool is part of the [Content Group Items Tools](./index) category.
</Info>

## Parameters

| Name               | Type   | Required | Description                                  |
| ------------------ | ------ | -------- | -------------------------------------------- |
| content\_group\_id | string | Yes      | The ID of the content group to get items for |

## Example Request

```json theme={null}
{
  "content_group_id": "cg_12345678"
}
```

## Example Response

```json theme={null}
[
  {
    "id": "cgi_12345678",
    "content_group_id": "cg_12345678",
    "platform": "INSTAGRAM",
    "platform_item_id": "ig_item_123",
    "type": "IMAGE",
    "title": "Beach Wear",
    "description": "Our new beach collection is perfect for summer holidays.",
    "media_url": "https://example.com/images/summer1.jpg",
    "thumbnail_url": "https://example.com/thumbnails/summer1_thumb.jpg",
    "position": 0,
    "engagement": {
      "views": 8543
    },
    "created_at": "2023-06-15T10:25:00.000Z",
    "updated_at": "2023-06-20T14:15:00.000Z"
  },
  {
    "id": "cgi_23456789",
    "content_group_id": "cg_12345678",
    "platform": "INSTAGRAM",
    "platform_item_id": "ig_item_456",
    "type": "IMAGE",
    "title": "Casual Collection",
    "description": "Everyday casual wear for the summer season.",
    "media_url": "https://example.com/images/summer2.jpg",
    "thumbnail_url": "https://example.com/thumbnails/summer2_thumb.jpg",
    "position": 1,
    "engagement": {
      "views": 7982
    },
    "created_at": "2023-06-15T10:25:00.000Z",
    "updated_at": "2023-06-20T14:15:00.000Z"
  },
  {
    "id": "cgi_34567890",
    "content_group_id": "cg_12345678",
    "platform": "INSTAGRAM",
    "platform_item_id": "ig_item_789",
    "type": "VIDEO",
    "title": "Behind the Scenes",
    "description": "Take a look at our summer photoshoot.",
    "media_url": "https://example.com/videos/summer3.mp4",
    "thumbnail_url": "https://example.com/thumbnails/summer3_thumb.jpg",
    "position": 2,
    "duration_in_seconds": 45,
    "engagement": {
      "views": 6214
    },
    "created_at": "2023-06-15T10:25:00.000Z",
    "updated_at": "2023-06-20T14:15:00.000Z"
  }
]
```

## Usage Notes

* The response is an array of content group item objects, ordered by their position in the content group.
* The `position` field indicates the order of items in the content group (0-indexed).
* Different media types (images, videos, etc.) can be included in the same content group, depending on platform support.
* Each item includes its own metadata such as title, description, and media URLs.
* Some platforms may provide item-specific engagement metrics, while others only track engagement at the group level.
* If the specified content group does not exist, a `404 Not Found` error will be returned.
* If the content group exists but has no items, an empty array will be returned.
* For the most up-to-date data, consider using [Fetch Content Group Items](./fetchContentGroupItems) before retrieving items.

## Platform-Specific Notes

* **Instagram**: Items represent individual images or videos in a carousel post.
* **Facebook**: Items can be photos in an album or multiple images/videos in a single post.
* **LinkedIn**: Items may represent slides in a carousel post or pages in a document.
* **YouTube**: Items could represent videos in a playlist.

## Related Tools

* [Get Content Group](../content-groups/getContentGroup) - Get information about the parent content group
* [Get Content Group Item](./getContentGroupItem) - Get a specific item by ID
* [Get Content Group Items By IDs](./getContentGroupItemsByIds) - Get specific items by their IDs
* [Fetch Content Group Items](./fetchContentGroupItems) - Fetch the latest items from the platform