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

​
Parameters

NameTypeRequiredDescription
content_group_idstringYesThe 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.