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

# Citation aggregation

> Citation aggregation (bearer-authed)



## OpenAPI

````yaml /api-reference/public-openapi.json get /api/public/v1/citations
openapi: 3.1.0
info:
  title: FixAEO Customer API
  version: 2026.05.23
  description: >-
    Bearer-authed read API over your FixAEO workspace. Create a key in Settings,
    then send it as `Authorization: Bearer <key>`. Every route is scoped to the
    key's own account.


    Generated from the server's OpenAPI spec — see
    scripts/build-public-openapi.py.
servers:
  - url: https://api.fixaeo.com
security:
  - bearerAuth: []
paths:
  /api/public/v1/citations:
    get:
      tags:
        - Public API
      summary: Citation aggregation
      description: Citation aggregation (bearer-authed)
      parameters:
        - $ref: '#/components/parameters/RangeQuery'
      responses:
        '200':
          description: Citation aggregation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Citations'
      security:
        - bearerAuth: []
components:
  parameters:
    RangeQuery:
      name: range
      in: query
      schema:
        type: string
        enum:
          - 7d
          - 30d
          - 90d
        default: 30d
      description: Time window for time-series + aggregations.
  schemas:
    Citations:
      type: object
      properties:
        domains:
          type: array
          items:
            $ref: '#/components/schemas/CitationDomain'
        total_citations:
          type: integer
        range:
          type: string
    CitationDomain:
      type: object
      properties:
        domain:
          type: string
        citations:
          type: integer
        share:
          type: number
          format: float
        bucket:
          type: string
          enum:
            - owned
            - competitor
            - third_party
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: fxa_
      description: |
        API keys generated via `POST /api/v1/me/api-keys`. Format:
        `Authorization: Bearer fxa_<32-char-secret>`. Only accepted on
        `/api/public/v1/*`. Cookie auth is rejected on that surface.

````