> ## Documentation Index > Fetch the complete documentation index at: https://docs.onsomble.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Prompt Results > See the answer collected for each prompt, the brand metrics calculated from it, and how the results changed over time. Filter by platform, region, or date. ## OpenAPI ````yaml /openapi/public-api-v1.json get /v1/sites/{siteId}/reports/prompt-results openapi: 3.0.0 info: title: Onsomble API description: >- Connect Onsomble to your reporting and operational workflows. Read discoverability results or start a Scan from another system. version: 1.0.0 contact: {} servers: - url: https://api.onsomble.ai description: Production security: - apiKeyAuth: [] tags: - name: Sites description: Sites connected to your account. - name: Clients description: Clients managed by agency accounts. - name: Scans description: Scan history, status, and controls. - name: Reports description: AI discoverability results. paths: /v1/sites/{siteId}/reports/prompt-results: get: tags: - Reports summary: Get Prompt Results description: >- See the answer collected for each prompt, the brand metrics calculated from it, and how the results changed over time. Filter by platform, region, or date. operationId: getPromptResults parameters: - name: siteId required: true in: path schema: type: string - name: platform required: false in: query description: >- Repeat to select AI platforms and collection methods, for example ?platform=chatgpt_app&platform=chatgpt_api. Omit to include every platform. schema: example: - chatgpt_app - chatgpt_api type: array items: type: string enum: - claude_api - chatgpt_api - gemini_api - perplexity_sonar_pro - chatgpt_app - gemini_app - google_ai_summaries_app - google_ai_mode_app - microsoft_copilot_app - perplexity_app - name: region required: false in: query description: >- Repeat to select regions, for example ?region=NZ®ion=AU. Omit to include all regions. schema: example: - NZ - AU type: array items: type: string - name: startDate required: false in: query description: >- Inclusive ISO calendar-date lower bound. Omit to include all earlier report data. schema: type: string example: '2026-07-01' - name: endDate required: false in: query description: >- Inclusive ISO calendar-date upper bound. Omit to include all later report data. schema: example: '2026-07-31' type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PromptResultsReportResponseDto' components: schemas: PromptResultsReportResponseDto: type: object properties: data: type: array items: $ref: '#/components/schemas/PromptResultDto' trends: type: array items: $ref: '#/components/schemas/PromptResultTrendDto' filters: $ref: '#/components/schemas/AppliedReportFiltersDto' required: - data - trends - filters PromptResultDto: type: object properties: date: type: string example: '2026-07-01' scanId: type: string format: uuid promptId: type: string format: uuid description: The immutable prompt ID. prompt: type: string example: Which platform helps teams with AI discoverability? category: type: string nullable: true example: research platform: $ref: '#/components/schemas/PublicPlatformDto' region: type: string nullable: true example: NZ responseText: type: string nullable: true example: >- Onsomble helps teams measure and improve how their brand appears in AI answers. description: The response returned by the platform. metrics: type: array items: $ref: '#/components/schemas/PromptResultMetricDto' required: - date - scanId - promptId - prompt - category - platform - region - responseText - metrics PromptResultTrendDto: type: object properties: promptId: type: string format: uuid prompt: type: string example: Which platform helps teams with AI discoverability? platform: $ref: '#/components/schemas/PublicPlatformDto' region: type: string nullable: true example: NZ points: type: array items: $ref: '#/components/schemas/PromptResultTrendPointDto' required: - promptId - prompt - platform - region - points AppliedReportFiltersDto: type: object properties: platform: example: - chatgpt_app - chatgpt_api description: Platform IDs applied to the report. Empty means all. type: array items: type: string region: example: - NZ - AU description: Region codes applied to the report. Empty means all. type: array items: type: string startDate: type: string nullable: true example: '2026-07-01' endDate: type: string nullable: true example: '2026-07-31' required: - platform - region - startDate - endDate PublicPlatformDto: type: object properties: id: type: string example: chatgpt_app description: Stable ID for the platform and collection method. name: type: string example: ChatGPT method: type: string enum: - web - api example: web description: >- How Onsomble collected the result: from the public website or through an API. required: - id - name - method PromptResultMetricDto: type: object properties: brand: type: string example: Acme type: type: string enum: - brand - competitor example: brand visibility: type: number example: 62.5 description: Visibility percentage. shareOfVoice: type: number example: 41.2 description: Share of Voice percentage. sentiment: type: object example: 62 nullable: true description: >- Average sentiment on a 0 to 100 scale (50 = neutral; runs finalized before the claims cutover used -100 to 100). Null when the brand has no sentiment evidence. mentionCount: type: number example: 3 description: Number of times the platform mentioned this brand. required: - brand - type - visibility - shareOfVoice - sentiment - mentionCount PromptResultTrendPointDto: type: object properties: date: type: string example: '2026-07-01' scanId: type: string format: uuid metrics: type: array items: $ref: '#/components/schemas/PromptResultMetricDto' required: - date - scanId - metrics securitySchemes: apiKeyAuth: scheme: bearer bearerFormat: ons_… type: http description: An API key created in Settings → Account → API Keys. ````