List Tracked Content

Returns paginated tracked content with citation, impression, and response metrics joined for the requested date range. Hidden content (is_hidden = true) is excluded.

Pagination uses page_size + 1 lookahead — pagination.has_more === true means the next page exists; there is no total-count field.

Use the sheet_id, content_type, and standard filters knobs to scope the result. Pass an unknown sheet_id (or one from another website) and the endpoint returns 403.

Request body

website_idstring uuid required

The website to list tracked content for.

Restrict to a single content type. manual is user-authored content created directly in the editor (the Blank Editor flow). athena_created is a shortcut for the four Athena-generated subtypes (draft, snipe, optimize, slice). Omit to span every type. This endpoint lists tracked (published) content, so a draft-state row — manual, draft, snipe, optimize, or slice — appears only after it is published.

sheet_idstring uuid

Restrict to content on a single Content Hub tab. Use GET /api/v1/content/sheets to discover IDs. Omit to span every tab.

mentionedboolean

If true, only count responses that mention your brand. If false, only count responses that do not. Omit to count every response.

page_numinteger

Zero-indexed page number.

page_sizeinteger

Number of items per page (1–100).

Example request

{
  "website_id": "123e4567-e89b-12d3-a456-426614174000",
  "filters": {
    "start_date": "2024-01-01T00:00:00.000Z",
    "end_date": "2024-01-31T23:59:59.999Z"
  },
  "sheet_id": "00000000-0000-4000-8000-000000000001",
  "page_size": 50
}

Response

Successful response with the page of tracked content.

Example response

{
  "content": [
    {
      "content_id": "11111111-2222-3333-4444-555555555555",
      "title": "Best CRMs for Startups, Reviewed",
      "url": "example.com/blog/crm-roundup",
      "normalized_url": "example.com/blog/crm-roundup",
      "type": "external",
      "topic_name": "CRM Software",
      "sheet_name": "3rd-Party Placements",
      "citations": 42,
      "citation_percent": 12.5,
      "estimated_impressions": 18400,
      "total_responses": 336,
      "mark_as_done_time": "2024-01-15T00:00:00.000Z",
      "created_at": "2024-01-10T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page_size": 50,
    "has_more": true
  }
}