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.

This tool is part of the Content Group Items Tools category.

Parameters

Name	Type	Required	Description
content_group_id	string	Yes	The ID of the content group to get items for

Example Request

{
  "content_group_id": "cg_12345678"
}

Example Response

[
  {
    "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 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 - Get information about the parent content group
• Get Content Group Item - Get a specific item by ID
• Get Content Group Items By IDs - Get specific items by their IDs
• Fetch Content Group Items - Fetch the latest items from the platform