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

# Live data and web search

> Search Tako's curated knowledge graph (finance, macro, companies, sports, weather) and the live web in one call. Returns knowledge cards — interactive, embeddable data visualizations with named sources — plus web results, with no LLM in the loop. Billed per search (`tako-search`; `deep` effort as `tako-search-deep`). Nothing calls Tako unless you call this route; register it as a tool and let the model decide when a turn needs live data.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/search
openapi: 3.0.3
info:
  title: AI Reserve Gateway API
  description: >-
    The AI Reserve API surface — OpenAI-compatible chat completions,
    Anthropic-compatible messages, Bedrock Converse, images, video, files,
    text-to-speech, realtime voice sessions, and provider-hidden GPU
    infrastructure — all behind one endpoint and one API key.
  version: 1.0.0
servers:
  - url: https://api.aireserve.com
security:
  - bearerAuth: []
tags:
  - name: Customers
    description: >-
      Per-end-customer usage, cost, and billable amounts for organizations that
      tag requests with their own customers.
  - name: GPU Infrastructure
    description: >-
      Provision and manage provider-hidden GPU instances. The recommended
      Instances API accepts workload requirements and an hourly price ceiling;
      AI Reserve handles provider placement internally. Every mutation is
      asynchronous and returns an operation to poll.
  - name: Customer keys
    description: >-
      Mint, list, and revoke API keys pinned to your own end customers (and
      their organizations), so spend splits per customer without per-request
      tagging.
paths:
  /v1/search:
    post:
      tags:
        - Search
      summary: Live data and web search
      description: >-
        Search Tako's curated knowledge graph (finance, macro, companies,
        sports, weather) and the live web in one call. Returns knowledge cards —
        interactive, embeddable data visualizations with named sources — plus
        web results, with no LLM in the loop. Billed per search (`tako-search`;
        `deep` effort as `tako-search-deep`). Nothing calls Tako unless you call
        this route; register it as a tool and let the model decide when a turn
        needs live data.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              additionalProperties: false
              type: object
              required:
                - query
              properties:
                query:
                  minLength: 1
                  maxLength: 2000
                  type: string
                effort:
                  anyOf:
                    - type: string
                      enum:
                        - instant
                    - type: string
                      enum:
                        - fast
                    - type: string
                      enum:
                        - deep
                sources:
                  additionalProperties: false
                  type: object
                  properties:
                    data:
                      additionalProperties: true
                      type: object
                      properties:
                        count:
                          minimum: 1
                          maximum: 20
                          type: integer
                        include_contents:
                          type: boolean
                    web:
                      additionalProperties: true
                      type: object
                      properties:
                        count:
                          minimum: 1
                          maximum: 20
                          type: integer
                        include_contents:
                          type: boolean
                country_code:
                  minLength: 2
                  maxLength: 2
                  type: string
                locale:
                  minLength: 2
                  maxLength: 20
                  type: string
                timezone:
                  minLength: 1
                  maxLength: 64
                  type: string
                  nullable: true
                output_settings:
                  additionalProperties: false
                  type: object
                  properties:
                    image_dark_mode:
                      type: boolean
                    force_refresh:
                      type: boolean
                  nullable: true
      responses:
        '200':
          description: Default Response
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your AI Reserve API key (aireserve_api_…) from the API Keys page in the
        portal (https://portal.aireserve.com/keys).

````

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