aimentiontracker-ai

aimentiontracker-ai API

aimentiontracker-ai API as documented publicly: 20 operations. Contract generated from the documentation by API Evangelist (2026-11-01); not the provider's own document.

Documentation GitHub OpenAPI

Operations 20

GET /agent This week: what the SEO agent did, and what is waiting on you #

GET /alerts Findings about your brand, newest first #

GET /answers The stored answers, with their mentions and citations #

GET /api/v1/brands GET /api/v1/brands #

GET /api/v1/keywords GET /api/v1/keywords #

GET /api/v1/me GET /api/v1/me #

GET /api/v1/visibility GET /api/v1/visibility #

GET /articles The articles the SEO agent chose, wrote and published, and why #

GET /articles/{id} One article in full, with the evidence it was chosen on #

GET /brands Every brand this key may read #

GET /competitor-gaps What each competitor ranks for that you do not, with the page that ranks #

GET /competitors Who the engines name instead of you #

GET /keywords The keywords the SEO agent ranks weekly, with who ranks above you #

GET /me Who this key is, and the rules for reading the numbers #

GET /questions The questions this workspace runs against the engines #

GET /recommendations What to do next, ranked, with the evidence #

GET /sentiment How the engines frame each brand when they name it #

GET /share-of-voice Each tracked brand's mentions as a share of every tracked brand's #

GET /sources The domains the engines read before answering #

GET /visibility Presence per engine and per brand over a trailing window #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/aimentiontracker-ai/openapi/_ae-authored/aimentiontracker-ai-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/aimentiontracker-ai/json-schema/aimentiontracker-ai-get-articles-id-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aimentiontracker-ai/json-schema/aimentiontracker-ai-get-articles-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aimentiontracker-ai/json-schema/aimentiontracker-ai-get-agent-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aimentiontracker-ai/json-schema/aimentiontracker-ai-get-api-v1-brands-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aimentiontracker-ai/json-schema/aimentiontracker-ai-get-brands-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/aimentiontracker-ai/json-schema/aimentiontracker-ai-get-me-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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/aimentiontracker-ai:aimentiontracker-ai-api"

All apis

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

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.1.0
info:
  title: aimentiontracker-ai API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 20 operation(s) read from 9 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; aimentiontracker-ai has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 4
    documentation: 16
    pages-with-code: 7
    pages-read: 9
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://rankhound.ai/docs/api
  - https://rankhound.ai/docs
  - https://rankhound.ai/docs/mcp
  - https://rankhound.ai/docs/brands
  - https://rankhound.ai/docs/quickstart
  - https://rankhound.ai/docs/cli
  - https://rankhound.ai/docs/errors
  - https://rankhound.ai/docs/reading-the-numbers
  - https://rankhound.ai/features/answer-tracking
servers:
- url: https://app.rankhound.ai
paths:
  /agent:
    get:
      operationId: get_agent
      tags:
      - Agent
      summary: 'This week: what the SEO agent did, and what is waiting on you'
      description: Success response contains data about the agent's weekly run.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Which brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAgentResponse'
      x-evidence:
        kind: documentation
  /alerts:
    get:
      operationId: get_alerts
      tags:
      - Alerts
      summary: Findings about your brand, newest first
      description: Read‑only endpoint returning a data envelope with alert objects.
      x-source: https://rankhound.ai/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /answers:
    get:
      operationId: get_answers
      tags:
      - Answers
      summary: The stored answers, with their mentions and citations
      description: Success response contains stored answer objects.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAnswersResponse'
      x-evidence:
        kind: documentation
  /api/v1/brands:
    get:
      operationId: get_api_v1_brands
      tags:
      - Api
      summary: GET /api/v1/brands
      x-source: https://rankhound.ai/docs/brands
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1BrandsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl curl -H "X-API-Key: $RANKHOUND_API_KEY" https://app.rankhound.ai/api/v1/brands data is an array. Each row: ( ● = always
          present) Field Type Meaning id ● Always present string The workspace public id. Pass as ?brand=. name ● Always present string Brand
          name. domain string | null The brand''s own domain, null before setup finishes. configured ● Always present boolean False means setup
          was never '
  /api/v1/keywords:
    get:
      operationId: get_api_v1_keywords
      tags:
      - Api
      summary: GET /api/v1/keywords
      x-source: https://rankhound.ai/docs/quickstart
      parameters:
      - name: brand
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -H "X-API-Key: $RANKHOUND_API_KEY"  "https://app.rankhound.ai/api/v1/keywords?brand=<id>" Before you render any of it Three
          rules for the SEO numbers Every SEO tool and endpoint carries these. Each one is a way to report a ranking or an article wrongly while
          looking right. 1 A null number is never zero. It means not measured yet, or, for a rank inside a completed check, not in the top 100.
          An'
  /api/v1/me:
    get:
      operationId: get_api_v1_me
      tags:
      - Api
      summary: GET /api/v1/me
      x-source: https://rankhound.ai/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -H "X-API-Key: $RANKHOUND_API_KEY" https://app.rankhound.ai/api/v1/me'
  /api/v1/visibility:
    get:
      operationId: get_api_v1_visibility
      tags:
      - Api
      summary: GET /api/v1/visibility
      x-source: https://rankhound.ai/docs/brands
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -H "X-API-Key: $RANKHOUND_API_KEY" "https://app.rankhound.ai/api/v1/visibility?days=30" '
  /articles:
    get:
      operationId: get_articles
      tags:
      - Articles
      summary: The articles the SEO agent chose, wrote and published, and why
      description: Success response contains a paginated list of article objects.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
        description: '"writing" | "waiting" | "scheduled" | "published" | "rejected" | "skipped" | "failed" | "all"'
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: 1 to 200, default 50
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Which brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetArticlesResponse'
      x-evidence:
        kind: documentation
  /articles/{id}:
    get:
      operationId: get_articles_id
      tags:
      - Articles
      summary: One article in full, with the evidence it was chosen on
      description: Success response contains full article details.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Which brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetArticlesIdResponse'
      x-evidence:
        kind: documentation
  /brands:
    get:
      operationId: get_brands
      tags:
      - Brands
      summary: Every brand this key may read
      description: Success response contains an array of brand objects.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: false
        schema:
          type: string
        description: Pass as ?brand= to filter when multiple brands
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBrandsResponse'
      x-evidence:
        kind: documentation
  /competitor-gaps:
    get:
      operationId: get_competitor_gaps
      tags:
      - Competitor Gaps
      summary: What each competitor ranks for that you do not, with the page that ranks
      description: Success response contains competitor gap entries.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCompetitorGapsResponse'
      x-evidence:
        kind: documentation
  /competitors:
    get:
      operationId: get_competitors
      tags:
      - Competitors
      summary: Who the engines name instead of you
      description: Success response contains competitor naming data.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCompetitorsResponse'
      x-evidence:
        kind: documentation
  /keywords:
    get:
      operationId: get_keywords
      tags:
      - Keywords
      summary: The keywords the SEO agent ranks weekly, with who ranks above you
      description: Success response contains an array of keyword objects.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetKeywordsResponse'
      x-evidence:
        kind: documentation
  /me:
    get:
      operationId: get_me
      tags:
      - Me
      summary: Who this key is, and the rules for reading the numbers
      description: Success response contains data and meta envelope.
      x-source: https://rankhound.ai/docs/api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMeResponse'
      x-evidence:
        kind: documentation
  /questions:
    get:
      operationId: get_questions
      tags:
      - Questions
      summary: The questions this workspace runs against the engines
      description: Read‑only endpoint returning a data envelope with the list of questions.
      x-source: https://rankhound.ai/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /recommendations:
    get:
      operationId: get_recommendations
      tags:
      - Recommendations
      summary: What to do next, ranked, with the evidence
      description: Success response contains a list of recommendations.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetRecommendationsResponse'
      x-evidence:
        kind: documentation
  /sentiment:
    get:
      operationId: get_sentiment
      tags:
      - Sentiment
      summary: How the engines frame each brand when they name it
      description: Read‑only endpoint returning a data envelope with sentiment analysis per brand.
      x-source: https://rankhound.ai/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /share-of-voice:
    get:
      operationId: get_share_of_voice
      tags:
      - Share Of Voice
      summary: Each tracked brand's mentions as a share of every tracked brand's
      description: Read‑only endpoint returning a data envelope with share‑of‑voice metrics.
      x-source: https://rankhound.ai/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sources:
    get:
      operationId: get_sources
      tags:
      - Sources
      summary: The domains the engines read before answering
      description: Success response contains source domain statistics.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSourcesResponse'
      x-evidence:
        kind: documentation
  /visibility:
    get:
      operationId: get_visibility
      tags:
      - Visibility
      summary: Presence per engine and per brand over a trailing window
      description: Success response contains visibility data per engine.
      x-source: https://rankhound.ai/docs/api
      parameters:
      - name: brand
        in: query
        required: true
        schema:
          type: string
        description: Brand to report on
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVisibilityResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetAgentResponse:
      type: object
      properties:
        week_start:
          type: string
          description: Monday (UTC) of the current week
        status:
          type: string
          description: '"not_started" | "running" | "done" | "failed"'
        skipped:
          type: boolean
          description: True when the week closed without running
        error:
          type: string
          description: Error message if status is failed
        steps:
          type: object
          description: Detailed step information
        articles:
          type: object
          description: Articles status for the week
        allowance:
          type: object
          description: Monthly article allowance
        setup:
          type: object
          description: Setup flags
        latest_summary:
          type: object
          description: Summary of the most recent weekly email
    GetAnswersResponse:
      type: object
      properties:
        answer_id:
          type: string
          description: Answer identifier
        mentions:
          type: array
          description: Mentions in the answer
        citations:
          type: array
          description: Citations for the answer
    GetApiV1BrandsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              domain:
                type: string
              configured:
                type: boolean
              active_prompts:
                type: integer
              market:
                type: object
                properties:
                  location_code:
                    type: integer
                  language_code:
                    type: string
              last_collected_at:
                type: string
                format: date-time
        meta:
          type: object
          properties:
            generated_at:
              type: string
              format: date-time
            pinned:
              type: boolean
            note:
              type: string
    GetArticlesResponse:
      type: object
      properties:
        id:
          type: string
          description: Public article id
        keyword:
          type: string
          description: Search term the article was written for
        intent:
          type: string
          description: '"new" | "rewrite"'
        source:
          type: string
          description: '"search_console" | "competitor_gap" | "keyword" | "manual"'
        status:
          type: string
          description: Current article status
        status_reason:
          type: string
          description: Reason for skipped or failed status
        title:
          type: string
          description: Article title
        why:
          type: string
          description: Why the agent chose this topic
        created_at:
          type: string
          description: When the topic was chosen
        scheduled_for:
          type: string
          description: Publishing slot
        published_at:
          type: string
          description: When the article was published
        published_url:
          type: string
          description: URL where the article went live
        results:
          type: object
          description: Search Console clicks and impressions
    GetArticlesIdResponse:
      type: object
      properties:
        id:
          type: string
          description: Public article id
        keyword:
          type: string
          description: Search term
        intent:
          type: string
          description: '"new" | "rewrite"'
        source:
          type: string
          description: '"search_console" | "competitor_gap" | "keyword" | "manual"'
        status:
          type: string
          description: Current status
        status_reason:
          type: string
          description: Reason for skipped or failed
        title:
          type: string
          description: Article title
        why:
          type: string
          description: Why the topic was chosen
        created_at:
          type: string
          description: When chosen
        scheduled_for:
          type: string
          description: Publishing slot
        published_at:
          type: string
          description: When published
        published_url:
          type: string
          description: Live URL
        results:
          type: object
          description: Live Search Console clicks and impressions
        slug:
          type: string
          description: URL slug
        meta_description:
          type: string
          description: Meta description
        body_markdown:
          type: string
          description: Article markdown
        evidence:
          type: object
          description: Snapshot of data when topic was chosen
        pages_to_beat:
          type: array
          description: Search results the article aims to beat
    GetBrandsResponse:
      type: object
      properties:
        id:
          type: string
          description: Workspace public id
        name:
          type: string
          description: Brand name
        domain:
          type: string
          description: Brand's own domain
        configured:
          type: boolean
          description: Setup completion flag
        active_prompts:
          type: integer
          description: Prompts currently running for this brand
        market:
          type: object
          description: Market location and language
        last_collected_at:
          type: string
          description: Timestamp of most recent stored answer
    GetCompetitorGapsResponse:
      type: object
      properties:
        competitor:
          type: string
          description: Competitor name
        keyword:
          type: string
          description: Keyword they rank for
        page_url:
          type: string
          description: URL of competitor's page
        position:
          type: integer
          description: Competitor's position
    GetCompetitorsResponse:
      type: object
      properties:
        engine:
          type: string
          description: Engine name
        competitor_brand:
          type: string
          description: Competitor brand named
        rate:
          type: object
          description: Rate object
    GetKeywordsResponse:
      type: object
      properties:
        keyword:
          type: string
          description: Keyword text
        rank:
          type: integer
          description: Current rank
        search_volume:
          type: integer
          description: Monthly searches
        difficulty:
          type: integer
          description: Keyword difficulty
        competitors:
          type: array
          description: Competitors ranking above
    GetMeResponse:
      type: object
      properties:
        organization:
          type: object
          description: Organization information
        plan:
          type: object
          description: Plan information
        key:
          type: object
          description: Key information
        brand:
          type: object
          description: Brand the response describes
        rate_limit:
          type: object
          description: Rate limit information
        reporting_rules:
          type: object
          description: Reporting rules
    GetRecommendationsResponse:
      type: object
      properties:
        recommendation_id:
          type: string
          description: Identifier
        title:
          type: string
          description: Recommendation title
        description:
          type: string
          description: Explanation
        evidence:
          type: object
          description: Evidence supporting the recommendation
    GetSourcesResponse:
      type: object
      properties:
        domain:
          type: string
          description: Source domain
        count:
          type: integer
          description: Number of times read
    GetVisibilityResponse:
      type: object
      properties:
        engine:
          type: string
          description: Engine name
        rate:
          type: object
          description: Rate object with present, responses, rate, min_sample
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
security:
- apiKey: []
tags:
- name: Agent
- name: Alerts
- name: Answers
- name: Api
- name: Articles
- name: Brands
- name: Competitor Gaps
- name: Competitors
- name: Keywords
- name: Me
- name: Questions
- name: Recommendations
- name: Sentiment
- name: Share Of Voice
- name: Sources
- name: Visibility