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

# Refresh a live data block

> Returns only the latest figure for one live `quote` or `score` block, without running a search. Use the block's `refresh` value as `ref`. Call it at most once a minute: calls within a minute share one copy.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/data/refresh
openapi: 3.1.0
info:
  title: Andi AI Search API
  version: 1.7.0
  description: >-
    Web search and page-fetch API for people and AI agents. `GET`/`POST
    /api/v1/search` returns structured results with query operators, domain and
    date filtering, and multiple output formats. `GET /api/v1/fetch` retrieves
    and extracts a single page. `GET /api/v1/news/:topic` returns a curated,
    ranked news feed for one of 27 fixed topics, with an optional `q` keyword
    filter. Search and fetch support `format=context`, which returns markdown
    suited to language models; the news endpoint also returns RSS and an HTML
    widget. By default (`searchMode=auto`) the API sets the search effort per
    query — compute, models, and depth — automatically; the fixed modes
    (`instant`, `low-cost`, `fast`, `balanced`, `deep`, `exhaustive`) pin an
    effort level when you want the same behavior on every call. Requests are
    billed on outcome-based pricing, reported per call in
    `metrics.cost_dollars`.
servers:
  - url: https://api.andiai.com
    description: Production
security:
  - apiKey: []
paths:
  /api/v1/data/refresh:
    get:
      summary: Refresh a live data block
      description: >-
        Returns only the latest figure for one live `quote` or `score` block,
        without running a search. Use the block's `refresh` value as `ref`. Call
        it at most once a minute: calls within a minute share one copy.
      operationId: refreshData
      parameters:
        - name: ref
          in: query
          required: true
          description: The `refresh` value of a `quote` or `score` block.
          schema:
            type: string
      responses:
        '200':
          description: The refreshed block and the time of its figures.
          content:
            application/json:
              schema:
                type: object
                properties:
                  quote:
                    $ref: '#/components/schemas/QuoteResult'
                  score:
                    $ref: '#/components/schemas/ScoreResult'
                  asOf:
                    type: string
                    description: When the figures were true, as an ISO 8601 time.
                description: Holds `quote` or `score`, matching the block you refreshed.
        '400':
          description: Missing `ref`, or `ref` is not a refresh value.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Credit balance exhausted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No live data matches this `ref`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: >-
            The figures could not be read and there is no earlier copy. Retry
            after the number of seconds in the `Retry-After` header.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    QuoteResult:
      type: object
      description: A share price.
      properties:
        symbol:
          type: string
          description: Ticker symbol.
        name:
          type: string
          description: Company name.
        exchange:
          type: string
          description: Exchange.
        price:
          type: number
          description: Latest price.
        currency:
          type: string
          description: Price currency code.
        change:
          type: number
          description: Change since the previous close.
        changePercent:
          type: number
          description: Change since the previous close, as a percent.
        previousClose:
          type: number
          description: Previous close.
        open:
          type: number
          description: Opening price.
        low:
          type: number
          description: Day low.
        high:
          type: number
          description: Day high.
        marketState:
          type: string
          enum:
            - open
            - closed
            - pre
            - post
          description: Market state.
        close:
          type: number
          description: >-
            The regular-session closing price, shown when the market is not open
            (`pre`, `post` or `closed`).
        extendedPrice:
          type: number
          description: The after-hours price, while `marketState` is `post`.
        extendedChange:
          type: number
          description: >-
            The after-hours change from the close, while `marketState` is
            `post`.
        delayMinutes:
          type: number
          description: Minutes the price is delayed, when delayed.
        series:
          type: array
          items:
            type: number
          description: The day's prices in 5-minute steps, oldest first.
        refresh:
          type: string
          description: >-
            Pass to `GET /api/v1/data/refresh` as `ref`. Present only while the
            market is open, pre or post.
        source:
          $ref: '#/components/schemas/DataSource'
          description: Who supplied the figures.
        asOf:
          type: string
          description: When the figures were true, as an ISO 8601 time.
        stale:
          type: boolean
          description: >-
            `true` when the latest figures could not be read and the last good
            copy is shown.
      required:
        - symbol
        - price
    ScoreResult:
      type: object
      description: A game.
      properties:
        league:
          type: string
          description: League name.
        status:
          type: string
          enum:
            - scheduled
            - live
            - halftime
            - final
            - postponed
            - cancelled
          description: Game status.
        clock:
          type: string
          description: Game clock as text, for example `67'` or `Q3 4:12`.
        startTime:
          type: string
          description: Start time, ISO 8601.
        teams:
          type: array
          description: The teams.
          items:
            type: object
            properties:
              name:
                type: string
                description: Team name.
              shortName:
                type: string
                description: Short name.
              logo:
                type: string
                description: Logo URL.
              score:
                type: integer
                description: Team score.
              home:
                type: boolean
                description: '`true` for the home team.'
            required:
              - name
        events:
          type: array
          items:
            type: string
          description: Key moments, when known.
        reason:
          type: string
          description: Why the game is postponed or cancelled.
        games:
          type: array
          description: >-
            The other games of a league or team search, in the same shape,
            nearest start first. Only on the top-level `score` block.
          items:
            type: object
        refresh:
          type: string
          description: >-
            Pass to `GET /api/v1/data/refresh` as `ref`. Present only while the
            game is live or at half-time.
        source:
          $ref: '#/components/schemas/DataSource'
          description: Who supplied the figures.
        asOf:
          type: string
          description: When the figures were true, as an ISO 8601 time.
        stale:
          type: boolean
          description: >-
            `true` when the latest figures could not be read and the last good
            copy is shown.
      required:
        - league
        - status
        - teams
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error type or message.
        message:
          type: string
          description: Detailed error description.
      required:
        - error
        - message
    DataSource:
      type: object
      description: 'Who supplied the figures: the original publisher, with a link.'
      properties:
        name:
          type: string
          description: Publisher name.
        url:
          type: string
          format: uri
          description: Link to the publisher's page for these figures.
      required:
        - name
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key from the [API Console](https://console.andiai.com).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.