> ## 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.

# Comprehensive industry metrics

> Comprehensive industry metrics (bearer-authed)



## OpenAPI

````yaml /api-reference/public-openapi.json get /api/public/v1/industry/metrics
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/industry/metrics:
    get:
      tags:
        - Public API
        - Industry
      summary: Comprehensive industry metrics
      description: Comprehensive industry metrics (bearer-authed)
      parameters:
        - $ref: '#/components/parameters/RangeQuery'
        - $ref: '#/components/parameters/EngineQuery'
        - name: region
          in: query
          schema:
            type: string
            default: us
        - name: language
          in: query
          schema:
            type: string
            default: en
        - name: brand_slug
          in: query
          schema:
            type: string
          description: Defaults to the primary brand.
      responses:
        '200':
          description: Industry metrics payload.
          content:
            application/json:
              schema:
                type: object
                properties:
                  brand_slug:
                    type: string
                  brand_name:
                    type: string
                  range:
                    type: string
                  from:
                    type: string
                    format: date
                  to:
                    type: string
                    format: date
                  engine:
                    type: string
                  region:
                    type: string
                  language:
                    type: string
                  last_refreshed:
                    type: string
                    format: date-time
                  ranking:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        mentions:
                          type: integer
                        share:
                          type: number
                        delta:
                          type: number
                        is_own:
                          type: boolean
                        is_pinned:
                          type: boolean
                        domain:
                          type: string
                          description: >-
                            Resolved competitor domain for the favicon; omitted
                            when unknown
                        sentiment:
                          type: object
                          properties:
                            pos:
                              type: integer
                            neu:
                              type: integer
                            neg:
                              type: integer
                  ranking_count:
                    type: integer
                  time_series:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          format: date
                        brand_mentions:
                          type: integer
                        total_responses:
                          type: integer
                        per_competitor:
                          type: object
                          additionalProperties:
                            type: integer
                  time_series_count:
                    type: integer
                  own:
                    type: object
                    properties:
                      total_mentions:
                        type: integer
                      total_responses:
                        type: integer
                      avg_position:
                        type: number
                  tracked_competitors:
                    type: array
                    items:
                      type: string
                  methodology:
                    type: object
      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.
    EngineQuery:
      name: engine
      in: query
      schema:
        type: string
        enum:
          - openai
          - anthropic
          - gemini
          - perplexity
          - grok
          - deepseek
      description: Filter to a single LLM engine.
  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.

````