> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.writesonic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get content-intelligence dashboard

> Returns project-level content-intelligence data for the dashboard: page and live-tracking summaries, the available filters and countries, the ranked list of tracked pages, page groups, and the columns shown in the page list.

**Example:** "List the Pages I'm tracking"

**Usage:** pick what you want with `view`: summary and live_summary for the headline numbers, countries and filters for the choices you can filter and sort by, pages for the ranked page list, groups for named page groups, and column_scope for the page-list columns. Scope the numbers with a market and a date window, and narrow the page list by search text, status, keyword intent, or group. The page list comes back in pages of up to 100 (50 by default). Use view=pages with a URL or title in search to find the page id other reports need, and view=filters to learn the real sort keys and ready-made presets before sorting.

**Response:** the data for the chosen view: summary metrics, the list of countries or filters, the ranked pages with their metrics, the page groups, or the page-list columns.



## OpenAPI

````yaml https://mcp.agent.writesonic.com/openapi.json post /api/v1/business/content-intelligence/dashboard
openapi: 3.1.0
info:
  title: hq-backend — Business API
  description: Public business tool endpoints (API-key auth).
  version: 0.1.0
servers: []
security: []
paths:
  /api/v1/business/content-intelligence/dashboard:
    post:
      tags:
        - business
      summary: Get content-intelligence dashboard
      description: >-
        Returns project-level content-intelligence data for the dashboard: page
        and live-tracking summaries, the available filters and countries, the
        ranked list of tracked pages, page groups, and the columns shown in the
        page list.


        **Example:** "List the Pages I'm tracking"


        **Usage:** pick what you want with `view`: summary and live_summary for
        the headline numbers, countries and filters for the choices you can
        filter and sort by, pages for the ranked page list, groups for named
        page groups, and column_scope for the page-list columns. Scope the
        numbers with a market and a date window, and narrow the page list by
        search text, status, keyword intent, or group. The page list comes back
        in pages of up to 100 (50 by default). Use view=pages with a URL or
        title in search to find the page id other reports need, and view=filters
        to learn the real sort keys and ready-made presets before sorting.


        **Response:** the data for the chosen view: summary metrics, the list of
        countries or filters, the ranked pages with their metrics, the page
        groups, or the page-list columns.
      operationId: get_ci_dashboard_api_v1_business_content_intelligence_dashboard_post
      parameters:
        - name: x-project-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            description: Project ID for tenant scoping
            title: X-Project-Id
          description: Project ID for tenant scoping
        - name: X-Workspace-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            description: Overrides the key's workspace
            title: X-Workspace-Id
          description: Overrides the key's workspace
        - name: X-API-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: User API key
            title: X-Api-Key
          description: User API key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CiDashboardArgs'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CiDashboardArgs:
      properties:
        view:
          $ref: '#/components/schemas/CiDashboardView'
          description: Which dashboard read to return.
        market_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Market Id
          description: Market (country) to scope metrics to.
        curr_start:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Curr Start
          description: >-
            Current window start date - pairs with curr_end/prev_start/prev_end:
            provide all four or omit all four (defaults to trailing 30 days),
            else 422. Each range needs start<end, equal current/prior length,
            and prev_end<=curr_start.
        curr_end:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Curr End
          description: Current window end date - see curr_start.
        prev_start:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Prev Start
          description: Comparison window start date - see curr_start.
        prev_end:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Prev End
          description: Comparison window end date - see curr_start.
        search:
          anyOf:
            - type: string
            - type: 'null'
          title: Search
          description: Filter pages by URL/title substring.
        statuses:
          anyOf:
            - items:
                $ref: '#/components/schemas/ContentIntelligencePageStatus'
              type: array
            - type: 'null'
          title: Statuses
          description: Filter the page list by lifecycle status.
        keyword_intent:
          anyOf:
            - items:
                $ref: '#/components/schemas/ContentIntelligenceKeywordIntent'
              type: array
            - type: 'null'
          title: Keyword Intent
          description: Keyword-intent filter.
        group_ids:
          anyOf:
            - items:
                type: string
                format: uuid
              type: array
            - type: 'null'
          title: Group Ids
          description: Filter the page list by page-group id.
        sort:
          anyOf:
            - type: string
            - type: 'null'
          title: Sort
          description: >-
            Sort the page list as '<key>:<dir>' (dir=asc|desc). Common keys:
            traffic, clicks, impressions, position, citations, citation_share,
            ai_bot_hits — and each one's _change/_change_pct trend variant (e.g.
            clicks_change_pct, ai_citation_count_change) for window-over-window
            ranking ('which pages gained/lost the most'), paired with
            curr_start/curr_end/prev_start/prev_end to set the two windows being
            compared. Call view=filters first for this project's current key
            list plus named presets (e.g. pages getting fewer clicks, sinking in
            rankings) that bundle a ready-made filter+sort.
        page:
          type: integer
          minimum: 1
          title: Page
          description: Page number for the pages list.
          default: 1
        size:
          type: integer
          maximum: 100
          minimum: 1
          title: Size
          description: Page size for the pages list.
          default: 50
      type: object
      required:
        - view
      title: CiDashboardArgs
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CiDashboardView:
      type: string
      enum:
        - countries
        - filters
        - summary
        - live_summary
        - pages
        - column_scope
        - groups
      title: CiDashboardView
    ContentIntelligencePageStatus:
      type: string
      enum:
        - pruned
        - redirect
        - not_indexed
        - cannibalizing
        - underperforming
        - new
        - stable
        - rising
        - declining
        - dormant
        - stale
        - thin
      title: ContentIntelligencePageStatus
      description: >-
        The unified `/pages` `status` filter: distinct union of performance +

        content status values (performance order first, then content-only).
        Routing

        onto the two columns is by membership in the two source enums; the
        shared

        `stable` matches both. Kept in sync via a drift-guard test.
    ContentIntelligenceKeywordIntent:
      type: string
      enum:
        - branded
        - non_branded
      title: ContentIntelligenceKeywordIntent
      description: >-
        The `/pages` `keyword_intent` filter: classifies a page by whether its

        primary target keyword contains any of the project's brand aliases.
        Modelled

        on `statuses` (multi-select; both-or-none selected = no filter). An
        *intent*

        signal, not a *traffic* signal.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````