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

# One answer with its brand mentions and sources

> `text` is GFM Markdown. Mention `spans` are `[start, end)` UTF-16 offsets into `text`; render it without raw HTML and highlight from the spans.



## OpenAPI

````yaml https://api.seomator.com/openapi.json get /v1/projects/{id}/answers/{answerId}
openapi: 3.1.0
info:
  title: SEOmator API
  version: 0.1.0
servers:
  - url: https://api.seomator.com
security: []
paths:
  /v1/projects/{id}/answers/{answerId}:
    get:
      tags:
        - ai visibility
      summary: One answer with its brand mentions and sources
      description: >-
        `text` is GFM Markdown. Mention `spans` are `[start, end)` UTF-16
        offsets into `text`; render it without raw HTML and highlight from the
        spans.
      parameters:
        - schema:
            type: string
            description: Project id (proj_…) or slug (the domain with dots as dashes).
          required: true
          description: Project id (proj_…) or slug (the domain with dots as dashes).
          name: id
          in: path
        - schema:
            type: string
            description: Answer id (ans_…).
          required: true
          description: Answer id (ans_…).
          name: answerId
          in: path
      responses:
        '200':
          description: Answer
          content:
            application/json:
              schema:
                type: object
                properties:
                  answer:
                    type: object
                    properties:
                      id:
                        type: string
                      promptId:
                        type: string
                      assistant:
                        type: string
                        enum:
                          - chatgpt
                          - ai_mode
                          - gemini
                      runDate:
                        type: string
                      status:
                        type: string
                      outcome:
                        type:
                          - string
                          - 'null'
                      analysisStatus:
                        type: string
                        enum:
                          - pending
                          - analyzed
                          - unparsed
                      model:
                        type:
                          - string
                          - 'null'
                      capturedAt:
                        type:
                          - string
                          - 'null'
                      failCode:
                        type:
                          - string
                          - 'null'
                        enum:
                          - no_result
                          - provider_error
                          - gave_up
                          - null
                      prompt:
                        type: string
                      text:
                        type:
                          - string
                          - 'null'
                      mentions:
                        type: array
                        items:
                          type: object
                          properties:
                            brandId:
                              type: string
                            rank:
                              type:
                                - number
                                - 'null'
                            firstOffset:
                              type:
                                - number
                                - 'null'
                            spans:
                              type: array
                              items:
                                type: array
                                prefixItems:
                                  - type: number
                                  - type: number
                            retrieved:
                              type: boolean
                              description: >-
                                One of the brand's pages is in the assistant's
                                source list
                            cited:
                              type: boolean
                              description: >-
                                The answer cites one of the brand's pages inline
                                (never for Gemini, which shows no inline
                                citations)
                            linked:
                              type: boolean
                              description: >-
                                The answer text links to one of the brand's
                                pages
                            verification:
                              type: string
                              enum:
                                - not_needed
                                - pending
                                - confirmed
                                - rejected
                                - unverified
                            nearbyCitations:
                              type: array
                              items:
                                type: number
                          required:
                            - brandId
                            - rank
                            - firstOffset
                            - spans
                            - retrieved
                            - cited
                            - linked
                            - verification
                            - nearbyCitations
                          additionalProperties: {}
                      citations:
                        type: array
                        items:
                          type: object
                          properties:
                            position:
                              type: number
                            offset:
                              type:
                                - number
                                - 'null'
                            label:
                              type: string
                            url:
                              type:
                                - string
                                - 'null'
                            domain:
                              type:
                                - string
                                - 'null'
                          required:
                            - position
                            - offset
                            - label
                            - url
                            - domain
                          additionalProperties: {}
                      sources:
                        type: array
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                            title:
                              type:
                                - string
                                - 'null'
                            host:
                              type: string
                            domain:
                              type: string
                            position:
                              type: number
                            publishedAt:
                              type:
                                - string
                                - 'null'
                              description: >-
                                When the page was published, as the assistant
                                reported it
                            retrieved:
                              type: boolean
                              description: 'In the assistant''s source list: it read the page'
                            linked:
                              type: boolean
                              description: Linked in the answer text
                            citationRank:
                              type:
                                - number
                                - 'null'
                              description: >-
                                Order of its first inline citation, 1 = cited
                                first; null when not cited
                          required:
                            - url
                            - title
                            - host
                            - domain
                            - position
                            - publishedAt
                            - retrieved
                            - linked
                            - citationRank
                          additionalProperties: {}
                      searchQueries:
                        type: array
                        items:
                          type: string
                        description: >-
                          The web searches the assistant ran for this answer
                          (ChatGPT)
                      products:
                        type: array
                        items:
                          type: object
                          properties:
                            title:
                              type: string
                            url:
                              type:
                                - string
                                - 'null'
                            price:
                              type:
                                - string
                                - 'null'
                            merchant:
                              type:
                                - string
                                - 'null'
                          required:
                            - title
                            - url
                            - price
                            - merchant
                          additionalProperties: {}
                      hasAds:
                        type: boolean
                      hasMap:
                        type: boolean
                    required:
                      - id
                      - promptId
                      - assistant
                      - runDate
                      - status
                      - outcome
                      - analysisStatus
                      - model
                      - capturedAt
                      - failCode
                      - prompt
                      - text
                      - mentions
                      - citations
                      - sources
                      - searchQueries
                      - products
                      - hasAds
                      - hasMap
                    additionalProperties: {}
                required:
                  - answer
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - bad_request
                - unauthorized
                - insufficient_credits
                - plan_limit
                - forbidden
                - not_found
                - conflict
                - rate_limit_exceeded
                - internal_server_error
                - service_unavailable
            message:
              type: string
            requestId:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

## Related topics

- [Brand visibility in AI answers, with counts and the previous period](https://docs.seomator.com/api-reference/ai-visibility/brand-visibility-in-ai-answers-with-counts-and-the-previous-period.md)
- [Answers: read what each AI assistant said](https://docs.seomator.com/reports/answers.md)
- [Metrics: visibility, share of voice and citations](https://docs.seomator.com/reports/metrics.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.