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

# List Tracked Pages

> List tracked pages for the project with optional URL search and citation stats. Date range uses inclusive UTC calendar days. When both startDate and endDate are omitted, the default range is today only (00:00:00.000Z through 23:59:59.999Z on the current UTC date). When only one bound is omitted, the missing bound defaults to today.



## OpenAPI

````yaml /v2/openapi.json get /page-tracker
openapi: 3.0.0
info:
  title: Promptwatch API v2
  description: >-
    API v2 for customer integrations with Promptwatch monitoring platform. This
    version provides improved structure, additional endpoints, and enhanced
    functionality.
  version: 2.0.0
  contact:
    name: Promptwatch Support
    email: team@promptwatch.com
    url: https://promptwatch.com
  license:
    name: Commercial
    url: https://promptwatch.com/terms-and-conditions
servers:
  - url: https://server.promptwatch.com/api/v2
    description: Promptwatch API v2
security: []
tags:
  - name: Authentication
    description: API key validation and authentication
  - name: Content
    description: >-
      AI content generation and optimization. Create content asynchronously and
      poll for results.
  - name: Content Gap
    description: Content gap analysis and recommendations
  - name: Models
    description: Available LLM models
  - name: Monitors
    description: Monitor management and CRUD operations
  - name: Page Tracker
    description: Track URLs and inspect citation stats, responses, and prompts
  - name: Prompts
    description: Prompt management and operations
  - name: Query Fanouts
    description: ChatGPT query fanout keywords
  - name: Responses
    description: LLM response data and analytics
  - name: Tags
    description: Tag management for prompts
  - name: Topics
    description: Topic management for prompts
  - name: Actions
    description: Action items (GEO suggestions and tasks)
  - name: Personas
    description: Persona configuration for monitors
  - name: Brands
    description: Brand management for competitive analysis
  - name: Visibility
    description: Brand visibility time series and competitor heatmaps
  - name: Citations
    description: Citation analytics from AI responses
  - name: Analytics
    description: Visitor analytics, AI crawler logs, sentiment, and brand visibility trends
  - name: Projects
    description: Project management (organization-level keys only)
  - name: Sitemap
    description: Sitemap crawl progress and discovered URLs
  - name: Site Health
    description: >-
      Crawled pages with SEO issues (titles, meta descriptions, H1, thin
      content)
  - name: Socials
    description: >-
      Social media citations (Reddit posts and YouTube videos) found in LLM
      responses
paths:
  /page-tracker:
    get:
      tags:
        - Page Tracker
      summary: List Tracked Pages
      description: >-
        List tracked pages for the project with optional URL search and citation
        stats. Date range uses inclusive UTC calendar days. When both startDate
        and endDate are omitted, the default range is today only (00:00:00.000Z
        through 23:59:59.999Z on the current UTC date). When only one bound is
        omitted, the missing bound defaults to today.
      operationId: listTrackedPages
      parameters:
        - schema:
            type: integer
            default: 1
            minimum: 1
          in: query
          name: page
          required: false
          description: Page number (1-based)
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
          in: query
          name: size
          required: false
          description: Page size
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Filter by URL substring
        - schema:
            type: string
            format: date
          in: query
          name: startDate
          required: false
          description: >-
            First inclusive UTC calendar day (YYYY-MM-DD). Defaults to today
            when omitted. Future dates return 400 DATE_RANGE_IN_FUTURE.
        - schema:
            type: string
            format: date
          in: query
          name: endDate
          required: false
          description: >-
            Last inclusive UTC calendar day (YYYY-MM-DD). Defaults to today when
            omitted. Future dates return 400 DATE_RANGE_IN_FUTURE.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                example:
                  pages:
                    - id: 6ba7b822-9dad-11d1-80b4-00c04fd430c8
                      url: https://example.com/pricing
                      title: Pricing
                      domainName: example.com
                      createdAt: '2026-03-15T10:00:00.000Z'
                      promptCount: 12
                      citationCount: 28
                      lastCitedAt: '2026-03-28T14:30:00.000Z'
                  total: 1
                  page: 1
                  size: 10
                  totalPages: 1
                properties:
                  pages:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Tracked page identifier
                        url:
                          type: string
                          description: Canonical page URL
                        title:
                          type: string
                          nullable: true
                          description: Page title
                        domainName:
                          type: string
                          description: Page domain
                        createdAt:
                          type: string
                          format: date-time
                          description: Timestamp (ISO 8601)
                        promptCount:
                          type: number
                          description: Distinct prompts citing this page in the date range
                        citationCount:
                          type: number
                          description: >-
                            Citation occurrences (responses citing this page) in
                            the date range
                        lastCitedAt:
                          type: string
                          format: date-time
                          description: Most recent citation timestamp in the date range
                          nullable: true
                      required:
                        - id
                        - url
                        - title
                        - domainName
                        - createdAt
                        - promptCount
                        - citationCount
                        - lastCitedAt
                      additionalProperties: false
                    description: Tracked pages for the project
                  total:
                    type: integer
                    description: Total items matching the request
                  page:
                    type: integer
                    description: Page number (1-based)
                  size:
                    type: integer
                    description: Page size
                  totalPages:
                    type: integer
                    description: Total pages for this page size
                required:
                  - pages
                  - total
                  - page
                  - size
                  - totalPages
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: TRACKED_PAGE_NOT_FOUND
                  message: Tracked page not found
                properties:
                  code:
                    type: string
                    description: Error code indicating the type of error
                    enum:
                      - TRACKED_PAGE_NOT_FOUND
                      - TRACKED_PAGE_ALREADY_EXISTS
                      - DATE_RANGE_IN_FUTURE
                      - INTERNAL_ERROR
                    example: TRACKED_PAGE_NOT_FOUND
                  message:
                    type: string
                    description: Human-readable error message
                    example: Tracked page not found
                required:
                  - code
                  - message
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                example:
                  error: Unauthorized
                  message: Missing or invalid X-API-Key header.
                properties:
                  error:
                    type: string
                    description: Error category (often aligned with HTTP semantics)
                  code:
                    type: string
                    description: Optional machine-readable code
                  message:
                    type: string
                    description: Human-readable explanation
                  details:
                    type: object
                    description: Optional structured detail (e.g. validation)
                    additionalProperties: true
                required:
                  - error
                  - message
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: TRACKED_PAGE_NOT_FOUND
                  message: Tracked page not found
                properties:
                  code:
                    type: string
                    description: Error code indicating the type of error
                    enum:
                      - TRACKED_PAGE_NOT_FOUND
                      - TRACKED_PAGE_ALREADY_EXISTS
                      - DATE_RANGE_IN_FUTURE
                      - INTERNAL_ERROR
                    example: TRACKED_PAGE_NOT_FOUND
                  message:
                    type: string
                    description: Human-readable error message
                    example: Tracked page not found
                required:
                  - code
                  - message
                additionalProperties: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key for authentication. Get yours from the Promptwatch dashboard
        under Settings > API Keys.

````