> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/content openapi: 3.1.0 info: title: AthenaHQ API description: >- AthenaHQ API provides programmatic access to manage your websites and prompts for AI-powered content optimization. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Production server security: - apiKey: [] tags: - name: Basics description: Core API operations for managing websites and prompts - name: Metrics description: Metrics and analytics endpoints for tracking AI visibility - name: Billing description: Billing and credits endpoints for managing usage - name: Team Management description: Endpoints for managing team members and invitations - name: Groups description: Endpoints for managing groups of websites - name: Content description: >- Endpoints for accessing Content Hub data — tabs, tracked URLs, and per-URL prompt breakdowns. - name: Pitch Workspace description: >- Endpoints for accessing pitch workspace reports — org-scoped pitch runs with competitors, prompts, attributes, and aggregate metrics. - name: Knowledge Base description: >- Endpoints for reading the brand Knowledge Base — approved brand facts and the pillars that organize them. paths: /api/v1/content: post: tags: - Content summary: List Tracked Content description: >- 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. operationId: listTrackedContent requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ContentListRequest' responses: '200': description: Successful response with the page of tracked content. content: application/json: schema: $ref: '#/components/schemas/ContentListResponse' example: 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_id: 00000000-0000-4000-8000-000000000001 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_num: 0 page_size: 50 has_more: true '400': description: Bad request — invalid parameters. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing_website_id: value: error: website_id is required invalid_website_id: value: error: website_id must be a uuid '401': description: Unauthorized — invalid or missing API key. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- Forbidden — you don't have access to this website, or a sub-resource ID (`prompt_ids`, `competitor_ids`, `location_ids`, `sheet_id`) belongs to another website. content: application/json: schema: $ref: '#/components/schemas/Error' examples: website: value: error: Unauthorized access to this website sheet: value: error: Unauthorized access to this sheet prompts: value: error: Unauthorized access to these prompts '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] components: schemas: ContentListRequest: type: object description: Request body for listing tracked content. required: - website_id - filters properties: website_id: type: string format: uuid description: The website to list tracked content for. example: 123e4567-e89b-12d3-a456-426614174000 filters: $ref: '#/components/schemas/ApiFilters' content_type: type: string enum: - external - imported - manual - athena_created - draft - snipe - optimize - slice description: >- 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_id: type: string format: uuid description: >- Restrict to content on a single Content Hub tab. Use `GET /api/v1/content/sheets` to discover IDs. Omit to span every tab. mentioned: type: boolean description: >- If `true`, only count responses that mention your brand. If `false`, only count responses that do not. Omit to count every response. page_num: type: integer minimum: 0 default: 0 description: Zero-indexed page number. page_size: type: integer minimum: 1 maximum: 100 default: 50 description: Number of items per page (1–100). example: 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 ContentListResponse: type: object required: - content - pagination properties: content: type: array items: $ref: '#/components/schemas/ContentItem' pagination: $ref: '#/components/schemas/Pagination' Error: type: object description: Error response object required: - error properties: error: type: string description: Error message describing what went wrong example: Unauthorized ApiFilters: type: object description: >- Filters for querying responses and metrics. Pass location filters in the JSON body as `filters.location_ids`. required: - start_date properties: start_date: type: string format: date-time description: Filter start date (UTC) example: '2024-01-01T00:00:00.000Z' end_date: type: string format: date-time description: Filter end date (UTC) example: '2024-12-31T23:59:59.999Z' models: type: array description: Filter by AI models items: type: string enum: - chatgpt - perplexity - gemini - google_ai_overview - copilot - claude - ai_mode - grok - deepseek example: - chatgpt - perplexity prompt_ids: type: array description: Filter by specific prompt IDs items: type: string format: uuid competitor_ids: type: array description: Filter by specific competitor IDs items: type: string format: uuid location_ids: type: array description: >- Filter by location IDs. Pass this in the JSON body as `filters.location_ids`, even when filtering by a single location. Use IDs returned by `GET /api/v1/locations`. items: type: string format: uuid example: - 123e4567-e89b-12d3-a456-426614174111 prompt_status: type: string enum: - active - paused description: Filter by prompt status prompt_type: type: string enum: - branded - non_branded description: Filter by prompt type ContentItem: type: object description: >- A tracked content item (1st-party draft, imported page, 3rd-party placement, etc.) with citation and impression metrics joined for the requested date range. required: - content_id - title - url - normalized_url - type - topic_name - sheet_id - sheet_name - citations - citation_percent - estimated_impressions - total_responses - mark_as_done_time - created_at properties: content_id: type: string format: uuid description: >- Unique identifier for the content item. Pass this as `content_id` to `POST /api/v1/content/prompts` to drill into per-prompt citation data. example: 11111111-2222-3333-4444-555555555555 title: type: string nullable: true description: Page or post title (nullable for unscraped URLs). example: Best CRMs for Startups, Reviewed url: type: string nullable: true description: Canonical URL (display form, may include `www.`). example: example.com/blog/crm-roundup normalized_url: type: string nullable: true description: >- URL after protocol/trailing-slash normalization. Used to join with citation data. example: example.com/blog/crm-roundup type: type: string nullable: true description: >- Content type — one of `external`, `imported`, `draft`, `snipe`, `optimize`, `slice` (or null for legacy rows). example: external topic_name: type: string nullable: true description: >- Topic the content is paired with (if any). 3rd-party content often has no topic. example: CRM Software sheet_id: type: string format: uuid nullable: true description: >- Content Hub tab the item is pinned to. `null` for content not pinned to any tab. sheet_name: type: string nullable: true description: Human-readable name of the tab. `null` when `sheet_id` is null. example: 3rd-Party Placements citations: type: number description: Count of AI responses in the date range that cite this URL. example: 42 citation_percent: type: number description: >- Percentage of all responses (in the date range, matching the filters) that cite this URL. example: 12.5 estimated_impressions: type: number nullable: true description: >- Estimated impressions attributable to the URL across the date range. May be null when impression modeling is not available for the matched prompts. example: 18400 total_responses: type: number description: >- Total responses considered for the citation calculation (the denominator behind `citation_percent`). example: 336 mark_as_done_time: type: string format: date-time description: >- When the content was marked as published / done in Content Hub. Falls back to `created_at` when the row was never marked. example: '2024-01-15T00:00:00.000Z' created_at: type: string format: date-time description: When the content row was created (UTC). example: '2024-01-10T00:00:00.000Z' Pagination: type: object description: >- Pagination metadata. Uses `page_size + 1` lookahead — `has_more=true` means the next page is non-empty. No total-count field, by design (avoids the extra `COUNT(*)` round-trip). required: - page_num - page_size - has_more properties: page_num: type: integer description: Zero-indexed page number returned. example: 0 page_size: type: integer description: Maximum items per page. example: 50 has_more: type: boolean description: '`true` if another page is available.' example: true securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- API key for authentication. You can create one [here](https://app.athenahq.ai/organization?tab=api). ````