find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/athenahq-ai:athenahq-ai-ai-search-value-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: AthenaHQ AI Search Value API
  description: AthenaHQ API provides programmatic access to manage your websites and prompts for AI-powered content optimization.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
- url: https://api.athenahq.ai
  description: Production server
security:
- apiKey: []
tags:
- name: AI Search Value
paths:
  /api/v1/ai-search-value:
    get:
      operationId: getAiSearchValue
      summary: Get AI Search Value
      description: 'AI Search Value for a website: topic-market value, captured value range, headroom, coverage, value-weighted AI share of voice, per-topic detail, and modeled attributed contribution.'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  assumptions_version:
                    anyOf:
                    - type: string
                    - type: 'null'
                  computed_at:
                    anyOf:
                    - type: string
                    - type: 'null'
                  has_computed_valuations:
                    type: boolean
                  is_stale_value:
                    type: boolean
                  market:
                    type: object
                    properties:
                      value_usd_mo:
                        type: number
                      topics_priced:
                        type: number
                      topics_total:
                        type: number
                      coverage_pct:
                        type: number
                      current_sov_pct:
                        type: number
                    required:
                    - value_usd_mo
                    - topics_priced
                    - topics_total
                    - coverage_pct
                    - current_sov_pct
                  captured:
                    type: object
                    properties:
                      conservative:
                        type: number
                      expected:
                        type: number
                      upside:
                        type: number
                    required:
                    - conservative
                    - expected
                    - upside
                  headroom:
                    type: object
                    properties:
                      conservative:
                        type: number
                      expected:
                        type: number
                      upside:
                        type: number
                    required:
                    - conservative
                    - expected
                    - upside
                  measured_responses:
                    type: number
                  topics:
                    type: array
                    items:
                      type: object
                      properties:
                        topic_id:
                          type: string
                        category:
                          type: string
                        local_intent:
                          type: boolean
                        share_basis:
                          type: string
                        pw_sov_pct:
                          type: number
                        mix_adjusted_share_pct:
                          type: number
                        mention_rate_pct:
                          type: number
                        drift_pp:
                          type: number
                        standard_error_pp:
                          type: number
                        responses_28d:
                          type: number
                        models_measured:
                          type: number
                        personas_measured:
                          type: number
                        locations_measured:
                          type: number
                        captured:
                          type: object
                          properties:
                            conservative:
                              type: number
                            expected:
                              type: number
                            upside:
                              type: number
                          required:
                          - conservative
                          - expected
                          - upside
                        headroom:
                          type: object
                          properties:
                            conservative:
                              type: number
                            expected:
                              type: number
                            upside:
                              type: number
                          required:
                          - conservative
                          - expected
                          - upside
                        counted_in_total:
                          type: boolean
                      required:
                      - topic_id
                      - category
                      - local_intent
                      - share_basis
                      - pw_sov_pct
                      - mix_adjusted_share_pct
                      - mention_rate_pct
                      - drift_pp
                      - standard_error_pp
                      - responses_28d
                      - models_measured
                      - personas_measured
                      - locations_measured
                      - captured
                      - headroom
                      - counted_in_total
                  merge_suggestions:
                    type: array
                    items:
                      type: object
                      properties:
                        topic_id_a:
                          type: string
                        topic_id_b:
                          type: string
                        name_a:
                          type: string
                        name_b:
                          type: string
                        similarity:
                          type: number
                      required:
                      - topic_id_a
                      - topic_id_b
                      - name_a
                      - name_b
                      - similarity
                  contribution:
                    type: object
                    properties:
                      modeled_attributed:
                        anyOf:
                        - type: object
                          properties:
                            conservative:
                              type: number
                            expected:
                              type: number
                            upside:
                              type: number
                          required:
                          - conservative
                          - expected
                          - upside
                        - type: 'null'
                      attributed_share:
                        anyOf:
                        - type: number
                        - type: 'null'
                      attribution_unavailable:
                        type: boolean
                    required:
                    - modeled_attributed
                    - attributed_share
                    - attribution_unavailable
                  forecast:
                    anyOf:
                    - type: object
                      properties:
                        id:
                          type: string
                        created_at:
                          type: string
                        days_elapsed:
                          type: number
                        share_delta_pp:
                          type: number
                        share_vs_do_nothing_pp:
                          type: number
                        captured_delta_expected:
                          type: number
                      required:
                      - id
                      - created_at
                      - days_elapsed
                      - share_delta_pp
                      - share_vs_do_nothing_pp
                      - captured_delta_expected
                    - type: 'null'
                required:
                - assumptions_version
                - computed_at
                - has_computed_valuations
                - is_stale_value
                - market
                - captured
                - headroom
                - measured_responses
                - topics
                - merge_suggestions
                - contribution
                - forecast
        '400':
          description: 'Bad Request: validation failed'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate Limited
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
      parameters:
      - name: website_id
        in: query
        required: true
        schema:
          type: string
      tags:
      - AI Search Value
      security:
      - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. You can create one [here](https://app.athenahq.ai/organization?tab=api).