> ## 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. # Add Tracked Pages > Track one or more URLs. Returns a structured result with added, skipped (already tracked), and failed (invalid URL) arrays. Responds 207 Multi-Status to reflect mixed per-URL outcomes. ## OpenAPI ````yaml /v2/openapi.json post /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: post: tags: - Page Tracker summary: Add Tracked Pages description: >- Track one or more URLs. Returns a structured result with added, skipped (already tracked), and failed (invalid URL) arrays. Responds 207 Multi-Status to reflect mixed per-URL outcomes. operationId: addTrackedPages requestBody: required: true content: application/json: schema: type: object required: - urls properties: urls: type: array items: type: string minItems: 1 maxItems: 100 description: >- URLs to track (max 100 per request). Invalid URLs are captured in the failed[] array rather than rejected. additionalProperties: false responses: '207': description: Default Response content: application/json: schema: type: object example: added: - url: https://example.com/pricing urlId: 6ba7b822-9dad-11d1-80b4-00c04fd430c8 trackedPageId: 7ca8c933-abad-22e2-91c5-11d15ge541d9 skipped: - url: https://example.com/about reason: ALREADY_EXISTS failed: - url: not-a-url reason: INVALID_URL properties: added: type: array items: type: object properties: url: type: string description: The canonical URL that was added urlId: type: string description: Internal URL identifier trackedPageId: type: string description: >- Tracked page identifier (use for GET/:id, DELETE/:id) required: - url - urlId - trackedPageId additionalProperties: false description: URLs successfully added to tracking skipped: type: array items: type: object properties: url: type: string description: The URL that was skipped reason: type: string enum: - ALREADY_EXISTS description: Reason the URL was skipped required: - url - reason additionalProperties: false description: URLs already tracked by this project failed: type: array items: type: object properties: url: type: string description: The URL that failed reason: type: string enum: - INVALID_URL description: Reason the URL failed required: - url - reason additionalProperties: false description: URLs that could not be tracked required: - added - skipped - failed 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. ````