ATathenahq
Content

List Tracked Content

Changed on

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.

post/api/v1/content

Request

  • Base URL
    https://api.athenahq.ai
  • Auth
    API key in header x-api-key

Request body

website_idstring uuid required

The website to list tracked content for.

content_type'external' | 'imported' | 'manual' | 'athena_created' | 'draft' | 'snipe' | 'optimize' | 'slice'

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. A sheet tab lists its own content; a view tab, the default tab included, lists the shared main pool (content not filed in any sheet), without the view's saved filters. 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
  }
}

Changes

  • 2d1d86d5e067Revision changes
    • breaking

      added subschema #2 to the request property allOf list

    • breaking

      the request property type changed from object to no type

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /