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

# List a keyword's stored AI answer runs

> Every run the AI answers Source made for this keyword, newest first, including the runs that changed nothing and emitted no event, which is most of them and exactly what a trend is made of. Empty for a keyword that does not monitor AI answers. `since` defaults to the last 7 days; `engine` narrows to one engine. Free: it reads stored rows and asks no engine.



## OpenAPI

````yaml /openapi.json get /v1/keywords/{id}/ai-answers/runs
openapi: 3.1.0
info:
  title: Nephia API
  description: >-
    The brand-monitoring API. Create a **keyword** and it polls the live Sources
    (X, Reddit, Youtube, TikTok, Bluesky, Hacker News, Mastodon, Lemmy, GitHub,
    Product Hunt, Stack Overflow, RSS, AI answers and Vinted) on an interval,
    keeps what matches, reads each mention for sentiment and intent, sorts it
    into your buckets and answers your own agent step over it. Read the result
    back as **mentions** (`GET /v1/mentions` across the whole Account, or per
    keyword), or have it pushed to you as signed webhook events and delivery
    channels. A search can carry several terms at once, OR'd into one upstream
    request at one tick's cost. Authenticate with an API key on your Account.
    Monitoring is sold as a subscription (keywords, terms, freshness and AI)
    with credits as the meter underneath; credit packs are overflow and never
    change a limit. Reading your own mentions is free; the semantic search mode
    and the AI passes are what meter. Request quota is per Account (all API keys
    share one bucket), by Plan: Free 60/min, Solo 350/min, Growth 700/min, Pro
    1200/min.
  version: 1.0.0
servers:
  - url: https://api.nephia.cc
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Account
    description: Account balance
  - name: Mentions
    description: Everything your keywords caught, across every Source
  - name: Keywords
    description: >-
      What you monitor. A keyword carries its terms, its Sources and its
      settings. Read, create, edit and pause them here.
  - name: Explore
    description: >-
      One question asked of the Sources once, priced first, without creating a
      keyword
  - name: AI
    description: Group, classify, agent and summarise passes over items you name
  - name: Vinted analytics
    description: Observed price history and per-day market statistics
paths:
  /v1/keywords/{id}/ai-answers/runs:
    get:
      tags:
        - Keywords
      summary: List a keyword's stored AI answer runs
      description: >-
        Every run the AI answers Source made for this keyword, newest first,
        including the runs that changed nothing and emitted no event, which is
        most of them and exactly what a trend is made of. Empty for a keyword
        that does not monitor AI answers. `since` defaults to the last 7 days;
        `engine` narrows to one engine. Free: it reads stored rows and asks no
        engine.
      operationId: getV1KeywordsByIdAiAnswersRuns
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          required: true
        - in: query
          name: since
          schema:
            type: string
            format: date-time
        - in: query
          name: engine
          schema:
            type: string
            enum:
              - chatgpt
              - gemini
              - perplexity
        - in: query
          name: limit
          schema:
            type: number
            minimum: 1
            maximum: 200
      responses:
        '200':
          description: Stored runs
          content:
            application/json:
              schema:
                type: object
                properties:
                  runs:
                    type: array
                    items:
                      $ref: '#/components/schemas/AiAnswerRun'
                required:
                  - runs
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '404':
          description: Keyword not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
        '429':
          description: >-
            Request quota exceeded. Retry after the `Retry-After` header
            (seconds). Response includes `RateLimit-*` headers (IETF draft-7).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                  - error
              example:
                error: Rate limit exceeded
                code: TOO_MANY_REQUESTS
components:
  schemas:
    AiAnswerRun:
      type: object
      properties:
        id:
          type: string
        keywordId:
          type: string
        engine:
          type: string
          enum:
            - chatgpt
            - gemini
            - perplexity
        model:
          type:
            - string
            - 'null'
        prompt:
          type: string
        country:
          type: string
        answerText:
          type: string
        truncated:
          type: boolean
        searched:
          type: boolean
        citations:
          type: array
          items:
            $ref: '#/components/schemas/AiCitation'
        mentions:
          type: array
          items:
            $ref: '#/components/schemas/AiTermMention'
        changed:
          type:
            - string
            - 'null'
          enum:
            - terms
            - citations
            - text
            - null
        previousRunId:
          type:
            - string
            - 'null'
        latencyMs:
          type: number
        askedAt:
          type: string
      required:
        - id
        - keywordId
        - engine
        - model
        - prompt
        - country
        - answerText
        - truncated
        - searched
        - citations
        - mentions
        - changed
        - previousRunId
        - latencyMs
        - askedAt
    AiCitation:
      type: object
      properties:
        url:
          type: string
        domain:
          type: string
        title:
          type:
            - string
            - 'null'
      required:
        - url
        - domain
        - title
    AiTermMention:
      type: object
      properties:
        term:
          type: string
        mentioned:
          type: boolean
        cited:
          type: boolean
        count:
          type: number
      required:
        - term
        - mentioned
        - cited
        - count
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created from the Nephia dashboard for your Account.

````