> ## 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. # Prompt Visibility Time Series > Get per-prompt visibility time series data (the chart lines for each prompt) ## OpenAPI ````yaml /v2/openapi.json get /prompt-visibility-time-series 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: /prompt-visibility-time-series: get: tags: - Visibility summary: Prompt Visibility Time Series description: >- Get per-prompt visibility time series data (the chart lines for each prompt) operationId: getPromptVisibilityTimeSeries parameters: - schema: type: string format: date in: query name: startDate required: false description: Start date for visibility data (YYYY-MM-DD). Max range 90 days. - schema: type: string format: date in: query name: endDate required: false description: End date for visibility data (YYYY-MM-DD). Max range 90 days. - schema: type: string enum: - day - week - month default: day in: query name: range required: false description: Time grouping for the data (day, week, or month) - schema: anyOf: - type: string - type: array items: type: string in: query name: models required: false description: 'Filter by LLM models. Repeat for multiple: models=x&models=y' - schema: type: string in: query name: llmMonitorId required: false description: Filter by specific LLM monitor ID - schema: anyOf: - type: string enum: - ORGANIC - BRAND_SPECIFIC - COMPETITOR_COMPARISON - type: array items: type: string enum: - ORGANIC - BRAND_SPECIFIC - COMPETITOR_COMPARISON in: query name: types required: false description: 'Filter by prompt types. Repeat for multiple: types=x&types=y' - schema: anyOf: - type: string - type: array items: type: string in: query name: tagIds required: false description: 'Filter by prompt tag IDs. Repeat for multiple: tagIds=x&tagIds=y' - schema: anyOf: - type: string - type: array items: type: string in: query name: topicIds required: false description: >- Filter by prompt topic IDs. Repeat for multiple: topicIds=x&topicIds=y - schema: type: string enum: - asc - desc default: desc in: query name: sortDirection required: false description: Direction to rank prompts by average visibility - schema: type: integer minimum: 1 in: query name: limit required: false description: Number of top-ranked prompts to return (omit for all prompts) - schema: type: integer minimum: 0 in: query name: offset required: false description: Number of top-ranked prompts to skip before applying limit responses: '200': description: Default Response content: application/json: schema: type: object properties: timeSeries: type: array description: >- Per-prompt visibility lines, one point per (prompt, bucket) items: type: object properties: date: type: string description: Bucket start date (YYYY-MM-DD) prompt: type: object properties: id: type: string description: Prompt ID prompt: type: string description: Prompt text type: type: string enum: - ORGANIC - BRAND_SPECIFIC - COMPETITOR_COMPARISON description: Prompt type required: - id - prompt - type additionalProperties: false averageVisibility: type: number description: >- Average visibility score (0-100) for the prompt in this bucket totalResponses: type: integer description: Number of responses for the prompt in this bucket mentionCount: type: integer description: >- Number of responses mentioning the brand in this bucket required: - date - prompt - averageVisibility - totalResponses - mentionCount additionalProperties: false prompts: type: array description: >- Per-prompt summary across the full range, ranked by average visibility items: type: object properties: prompt: type: object properties: id: type: string description: Prompt ID prompt: type: string description: Prompt text type: type: string enum: - ORGANIC - BRAND_SPECIFIC - COMPETITOR_COMPARISON description: Prompt type isActive: type: boolean description: Whether the prompt is active required: - id - prompt - type - isActive additionalProperties: false averageVisibility: type: number description: Daily-averaged visibility score (0-100) daysWithMentions: type: integer description: Number of buckets with at least one brand mention totalDays: type: integer description: Number of buckets with responses totalResponses: type: integer description: Total responses for the prompt in the range required: - prompt - averageVisibility - daysWithMentions - totalDays - totalResponses additionalProperties: false totalPrompts: type: integer description: >- Total number of prompts matching the filters (ignores limit/offset), for pagination required: - timeSeries - prompts - totalPrompts additionalProperties: false '400': description: Default Response content: application/json: schema: type: object example: error: Bad Request code: DATE_RANGE_TOO_LARGE message: Date range cannot exceed 90 days properties: error: type: string description: Error label code: type: string description: Optional machine-readable code (e.g. DATE_RANGE_TOO_LARGE) message: type: string description: Reason the request was rejected required: - error - message '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: INTERNAL_ERROR message: An unexpected error occurred while computing visibility. properties: code: type: string description: Error code indicating the type of error enum: - INTERNAL_ERROR example: INTERNAL_ERROR message: type: string description: Human-readable error message example: An unexpected error occurred required: - code - message additionalProperties: false example: code: INTERNAL_ERROR message: An unexpected error occurred 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. ````