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

# Search AI Data

> Perform a search query using AI to retrieve relevant information based on the provided criteria.



## OpenAPI

````yaml openapi/zh/querit.json POST /apis/v1/querit/search
openapi: 3.1.0
info:
  description: ''
  title: Querit
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/querit/search
  x-aisa-document:
    facts_hash: eb76538dd649bf57a9af546cb45d9e0a33261444f17a79336f2dde84c2eea129
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:94ea5a667a6925253ae34d8e42bc41f091721e0501ef7ab44fe97b5e8fe61a30
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: querit
  x-aisa-catalogs:
    querit:
      title: Querit
      description: ''
      x-aisa-document:
        facts_hash: eb76538dd649bf57a9af546cb45d9e0a33261444f17a79336f2dde84c2eea129
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/querit/search:
    post:
      tags:
        - default
      summary: Search AI Data
      description: >-
        Perform a search query using AI to retrieve relevant information based
        on the provided criteria.
      operationId: any_querit_apis_v1_querit_search
      requestBody:
        required: true
        description: >-
          Top-level parameters:

          highlights object form:

          filters sub-object:

          timeRange.date syntax:

          d[n] / w[n] / m[n] / y[n]: last n days / weeks / months / years, e.g.
          d7, m3

          YYYY-MM-DDtoYYYY-MM-DD: a range, e.g. 2022-04-01to2022-07-30; a single
          day uses the same to form

          geo.countries.include allowed values: argentina, australia, brazil,
          canada, colombia, france, germany, india, indonesia, japan, mexico,
          nigeria, philippines, south korea, spain, united kingdom, united
          states.

          languages.include allowed values: english, japanese, korean, german,
          french, spanish, portuguese.

          vertical allowed values: code, finance. Lowercase and strictly
          enumerated; omit the field for universal search.
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: Search term. Supports long natural-language descriptions
                count:
                  type: integer
                  description: >-
                    Maximum number of results returned. Default: server default
                    (value unspecified).
                chunksPerDoc:
                  type: integer
                  description: >-
                    Summary chunks per document. Free / PAYG support up to 1;
                    Enterprise up to 3. Deprecated — still available, but
                    migrate to highlights
                  default: 1
                highlights:
                  anyOf:
                    - type: boolean
                    - type: object
                      properties:
                        query:
                          type: string
                          description: >-
                            Keyword that guides the extraction; falls back to
                            the top-level query when omitted
                        maxCharacters:
                          type: integer
                          description: >-
                            Length of each extracted fragment, in characters,
                            between 100 and 8000; the model picks the most
                            suitable length when omitted
                          minimum: 100
                          maximum: 8000
                  description: >-
                    Request relevant fragments from the body text. true extracts
                    against the original query at the length the model judges
                    best; the object form takes query and maxCharacters, see
                    below
                needContent:
                  type: boolean
                  description: >-
                    Whether to return body text. When true, body text lands in
                    each result's sentence field (sentence array)
                  default: false
                filters:
                  type: object
                  description: Filter conditions, see below
                  properties:
                    sites:
                      type: object
                      properties:
                        include:
                          type: array
                          items:
                            type: string
                          description: >-
                            Only pull results from these sites; an empty array
                            means no restriction
                        exclude:
                          type: array
                          items:
                            type: string
                          description: Exclude these sites
                    timeRange:
                      type: object
                      properties:
                        date:
                          type: string
                          description: Time range, syntax below
                    geo:
                      type: object
                      properties:
                        countries:
                          type: object
                          properties:
                            include:
                              type: array
                              items:
                                type: string
                                enum:
                                  - argentina
                                  - australia
                                  - brazil
                                  - canada
                                  - colombia
                                  - france
                                  - germany
                                  - india
                                  - indonesia
                                  - japan
                                  - mexico
                                  - nigeria
                                  - philippines
                                  - south korea
                                  - spain
                                  - united kingdom
                                  - united states
                              description: Only return results from these countries
                    languages:
                      type: object
                      properties:
                        include:
                          type: array
                          items:
                            type: string
                            enum:
                              - english
                              - japanese
                              - korean
                              - german
                              - french
                              - spanish
                              - portuguese
                          description: Only return results in these languages
                    vertical:
                      type: string
                      description: >-
                        Vertical search. Supported values: "code", "finance";
                        omit for universal search
                      enum:
                        - code
                        - finance
              required:
                - query
      responses:
        '200':
          description: >-
            Official response table. Fields on each results.result[] item: url,
            title, snippet, page_age (plaintext UTC+0 time), site_name,
            site_icon, sentence (string[], present only when needContent: true
            and body text is available), highlights (string[], present only when
            highlights is set on the request and body text is available). Every
            result field is optional. Some results in the same response may have
            no sentence or highlights. Treat a missing field as "body text
            unavailable," not as an error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  took:
                    type: string
                    description: Server-side processing time
                  error_code:
                    type: integer
                    description: >-
                      Error code, consistent with the HTTP status code; 200 on
                      success
                  error_msg:
                    type: string
                    description: Error detail
                  search_id:
                    type: integer
                    description: >-
                      Unique request identifier; give it to support when
                      reporting an issue
                  query_context:
                    type: object
                    properties:
                      query:
                        type: string
                        description: The query that was actually executed
                  results:
                    type: object
                    properties:
                      result:
                        type: array
                        items:
                          type: object
                        description: Result array
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

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