Aito Technologies

Aito Technologies query API

The query API from Aito Technologies — 15 operation(s) for query.

GitHub OpenAPI

Operations 15

POST /api/v1/jobs/{query}
GET /api/v1/jobs/
GET /api/v1/jobs/{uuid}
GET /api/v1/jobs/{uuid}/result
POST /api/v1/_similarity #
POST /api/v1/_predict #
POST /api/v1/_match #
POST /api/v1/_recommend #
POST /api/v1/_relate #
POST /api/v1/_query #
POST /api/v1/_aggregate #
POST /api/v1/_estimate #
POST /api/v1/_evaluate #
POST /api/v1/_batch #

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/aito-technologies/refs/heads/main/authentication/aito-technologies-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/aito-technologies/refs/heads/main/openapi/aito-technologies-query-api-openapi.yml

Other Resources

🔗
Swagger
https://aito.ai/docs/api/

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/aito-technologies-query-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aito-technologies-query-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Aito Technologies data Query API
servers:
- url: https://shared.aito.ai
  description: Base URL reconciled from apis.yml
security:
- ApiKeyAuth: []
tags:
- name: query
paths:
  /api/v1/jobs/{query}:
    post:
      tags:
      - query
      parameters:
      - $ref: '#/components/parameters/Query'
      description: Create a job for a query
      responses:
        200:
          description: Job info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobsResponse'
        400:
          description: Invalid request body
  /api/v1/jobs/:
    get:
      tags:
      - query
      description: Get status for all jobs
      responses:
        200:
          description: Job statuses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobsStatusResponse'
        400:
          description: Invalid request body
  /api/v1/jobs/{uuid}:
    get:
      tags:
      - query
      description: Get status for a job
      responses:
        200:
          description: Job status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobsStatusResponse'
        400:
          description: Invalid request body
  /api/v1/jobs/{uuid}/result:
    get:
      tags:
      - query
      description: Get result for an evaluate job query
      responses:
        200:
          description: Evaluate job result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluateResponse'
        400:
          description: Invalid request body
  /api/v1/_search:
    post:
      tags:
      - query
      operationId: search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchQuery'
      responses:
        200:
          description: Search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_similarity:
    post:
      tags:
      - query
      operationId: similarity
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SimilarityQuery'
      responses:
        200:
          description: Similarity results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_predict:
    post:
      tags:
      - query
      operationId: predict
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PredictQuery'
      responses:
        200:
          description: Predict results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_match:
    post:
      tags:
      - query
      operationId: match
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MatchQuery'
      responses:
        200:
          description: Match results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_recommend:
    post:
      tags:
      - query
      operationId: recommend
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecommendQuery'
      responses:
        200:
          description: Recommend results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_relate:
    post:
      tags:
      - query
      operationId: relate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelateQuery'
      responses:
        200:
          description: Relate results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_query:
    post:
      tags:
      - query
      operationId: query
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Query'
      responses:
        200:
          description: Query results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_aggregate:
    post:
      tags:
      - query
      operationId: aggregate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AggregateQuery'
      responses:
        200:
          description: Aggregate results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecoratedHits'
        400:
          description: Invalid request body
  /api/v1/_estimate:
    post:
      tags:
      - query
      operationId: estimate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EstimateQuery'
      responses:
        200:
          description: Estimate results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EstimateResult'
        400:
          description: Invalid request body
  /api/v1/_evaluate:
    post:
      tags:
      - query
      operationId: evaluate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EvaluateQueryBase'
      responses:
        200:
          description: Evaluate results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluateResponse'
        400:
          description: Invalid request body
  /api/v1/_batch:
    post:
      tags:
      - query
      operationId: batch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchQuery'
      responses:
        200:
          description: Batch results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchQueryResults'
        400:
          description: Invalid request body
components:
  schemas:
    EvaluateGenericQuery:
      type: object
      example:
        from: impressions
        get: product
        limit: 20
        offset: 10
      required:
      - from
      properties:
        from:
          example: impressions
          $ref: '#/components/schemas/From'
        where:
          $ref: '#/components/schemas/Proposition'
        get:
          example: product
          $ref: '#/components/schemas/Get'
        orderBy:
          $ref: '#/components/schemas/OrderBy'
        select:
          $ref: '#/components/schemas/Projection'
        offset:
          example: 10
          type: integer
          format: int64
          description: The number of results to skip from the beginning.
          default: 0
        limit:
          example: 20
          type: integer
          format: int64
          description: The maximum number of results to retrieve.
          default: 10
    EvaluatePredict:
      type: object
      example:
        from: products
        predict: category
        where:
          name:
            $get: name
      required:
      - from
      - predict
      properties:
        from:
          example: products
          $ref: '#/components/schemas/From'
        where:
          example:
            name:
              $get: name
          $ref: '#/components/schemas/Proposition'
        predict:
          example: category
          $ref: '#/components/schemas/PropositionSet'
        basedOn:
          $ref: '#/components/schemas/PropositionSet'
        exclusiveness:
          type: boolean
        select:
          $ref: '#/components/schemas/Projection'
        offset:
          type: integer
          format: int64
        limit:
          type: integer
          format: int64
    Proposition:
      example:
        customer: 4
        query:
          $match: laptop
      examples:
      - customer: 4
        query:
          $match: laptop
      - price:
          $gte: 50
          $lt: 100
      - tags:
          $match: laptop
      type: object
      oneOf:
      - $ref: '#/components/schemas/Is'
      - $ref: '#/components/schemas/And'
      - $ref: '#/components/schemas/Atomic'
      - $ref: '#/components/schemas/Or'
      - $ref: '#/components/schemas/Not'
      - $ref: '#/components/schemas/Defined'
      - $ref: '#/components/schemas/Has'
      - $ref: '#/components/schemas/Exists'
      - $ref: '#/components/schemas/Match'
      - $ref: '#/components/schemas/StartsWith'
      - $ref: '#/components/schemas/On'
      - $ref: '#/components/schemas/Hash'
      - $ref: '#/components/schemas/Mod'
      - $ref: '#/components/schemas/Gt'
      - $ref: '#/components/schemas/Gte'
      - $ref: '#/components/schemas/Lt'
      - $ref: '#/components/schemas/Lte'
      - $ref: '#/components/schemas/Context'
      - $ref: '#/components/schemas/Knn'
      - $ref: '#/components/schemas/Nn'
      - $ref: '#/components/schemas/Numeric'
      - oneOf:
        - $ref: '#/components/schemas/ToString'
        - $ref: '#/components/schemas/GetValueExpression'
      - $ref: '#/components/schemas/FieldProposition'
    PlainSimilarity:
      example: $similarity
      examples:
      - $similarity
      - from: product
        get: message
        orderBy: $similarity
        where:
          title:
            $match: iphone
      type: string
      enum:
      - $similarity
    From:
      example:
        from: impressions
        where:
          click: true
      examples:
      - from: impressions
        where:
          click: true
      - impressions
      - from:
          from: impressions
          where:
            click: true
        orderBy: $p
        where:
          query: laptop
      - from: impressions
      oneOf:
      - $ref: '#/components/schemas/FromWhere'
      - $ref: '#/components/schemas/FromTablequery'
    ParametricLiftScore:
      example:
        $probabilityLift:
          of: tags
      examples:
      - $probabilityLift:
          of: tags
      - $probabilityLift:
          of:
          - tags
          - title
      - $probabilityLift:
          of:
            $context:
              click: true
          basedOn:
          - title
          - tags
          - category
      - from: impressions
        where:
          product.title:
            $match: iphone
        get: product
        orderBy:
          $probabilityLift:
            of: tags
      type: object
      properties:
        $probabilityLift:
          type: object
          properties:
            of:
              $ref: '#/components/schemas/PropositionSet'
            basedOn:
              $ref: '#/components/schemas/PropositionSet'
    FreqP:
      example:
        $freqP:
          f: clickCount
          n: impressionCount
          p: 0.5
      type: object
      properties:
        $freqP:
          type: object
          properties:
            f:
              $ref: '#/components/schemas/Value'
            n:
              $ref: '#/components/schemas/Value'
            p:
              $ref: '#/components/schemas/Value'
    RelateQuery:
      type: object
      example:
        from: impressions
        limit: 2
        offset: 2
        relate: prevProduct
        select:
        - related
        - condition
        - lift
        - ps
        - fs
        where:
          customer: 4
          query: laptop
      required:
      - from
      - relate
      properties:
        from:
          example: impressions
          $ref: '#/components/schemas/From'
        where:
          example:
            customer: 4
            query: laptop
          $ref: '#/components/schemas/Proposition'
        relate:
          example: prevProduct
          $ref: '#/components/schemas/PropositionSet'
        orderBy:
          $ref: '#/components/schemas/RelateOrderBy'
        select:
          example:
          - related
          - condition
          - lift
          - ps
          - fs
          $ref: '#/components/schemas/Selection'
        offset:
          example: 2
          type: integer
          format: int64
          description: The number of results to skip from the beginning.
          default: 0
        limit:
          example: 2
          type: integer
          format: int64
          description: The maximum number of results to retrieve.
          default: 10
    KnnPropositionObject:
      type: object
      example:
        k: 4
        near:
          tags: laptop
      required:
      - k
      - near
      properties:
        k:
          example: 4
          type: integer
          format: int32
        near:
          example:
            tags: laptop
          oneOf:
          - $ref: '#/components/schemas/Proposition'
          - $ref: '#/components/schemas/PrimitiveProposition'
    BaseProbabilityExplanation:
      example:
        proposition:
          click: true
        type: baseP
        value: 0.5
      type: object
      required:
      - type
      - value
      properties:
        type:
          description: 'The explanation type: baseP.

            '
          enum:
          - baseP
          type: string
        value:
          description: 'The prior probability.

            '
          type: number
        proposition:
          description: 'The variable.

            '
          $ref: '#/components/schemas/PropositionExplanation'
    FromWhere:
      type: object
      example:
        from: impressions
        where:
          click: true
      required:
      - from
      - where
      properties:
        from:
          example: impressions
          $ref: '#/components/schemas/From'
        where:
          example:
            click: true
          $ref: '#/components/schemas/Proposition'
        limit:
          type: integer
          format: int64
    DefaultValueExplanation:
      example:
        type: default
        value: 1.0
      type: object
      required:
      - type
      - value
      properties:
        type:
          description: 'The explanation type: default value.

            '
          enum:
          - default
          type: string
        value:
          description: 'The default value.

            '
          type: number
    AggregateField:
      example: price.$mean
      examples:
      - price.$mean
      - price.$sum
      type: string
    FieldPropositionExplanation:
      type: object
      required:
      - fieldName
      properties:
        fieldName:
          $ref: '#/components/schemas/PropositionExplanation'
    OrExplanation:
      type: object
      properties:
        $or:
          type: array
          items:
            $ref: '#/components/schemas/PropositionExplanation'
    PlainSameness:
      example: $sameness
      examples:
      - $sameness
      - from: product
        orderBy: $sameness
        where:
          title:
            $match: iphone
      type: string
      enum:
      - $sameness
    LtExplanation:
      type: object
      properties:
        $lt:
          oneOf:
          - $ref: '#/components/schemas/IntArray'
          - $ref: '#/components/schemas/LongArray'
          - $ref: '#/components/schemas/DecimalArray'
          - $ref: '#/components/schemas/StringArray'
          - $ref: '#/components/schemas/BooleanArray'
          - type: object
          - type: object
          - type: object
          - type: object
          - type: object
          - type: integer
            format: int32
          - type: integer
            format: int64
          - type: number
          - type: boolean
          - type: 'null'
          - type: string
          - type: object
    MaxScore:
      example:
        $max:
          $context: score
      type: object
      properties:
        $max:
          $ref: '#/components/schemas/ContextValueQuery'
    ProjectionField:
      example: price
      type: string
    ContextPropositionQuery:
      example:
        $context:
          click: true
      type: object
      properties:
        $context:
          $ref: '#/components/schemas/Proposition'
    Pow:
      example:
        $pow:
        - width
        - 2
      type: object
      properties:
        $pow:
          oneOf:
          - $ref: '#/components/schemas/ExponentPropositionObject'
          - $ref: '#/components/schemas/ExponentPropositionArray'
    LongArray:
      example:
      - 1000000000000
      - 2000000000000
      type: array
      items:
        type: integer
        format: int64
    SamenessScore:
      example:
        $sameness:
          title: apple iphone
          tags: premium ios phone
      examples:
      - $sameness:
          title: apple iphone
          tags: premium ios phone
      - from: products
        orderBy:
          $sameness:
            title: apple iphone
            tags: premium ios phone
      type: object
      properties:
        $sameness:
          oneOf:
          - $ref: '#/components/schemas/Proposition'
          - $ref: '#/components/schemas/PrimitiveProposition'
    RankProjection:
      example: $rank
      type: string
      enum:
      - $rank
    EvaluateQueryBase:
      oneOf:
      - $ref: '#/components/schemas/EvaluateGroupedQuery'
      - $ref: '#/components/schemas/EvaluateEstimateQuery'
      - $ref: '#/components/schemas/EvaluateQuery'
    PField:
      example: $p
      type: string
      enum:
      - $p
    Knn:
      example:
        $knn:
        - 4
        - tags: laptop
      examples:
      - $knn:
        - 4
        - tags: laptop
      - $knn:
          k: 4
          near:
            tags: laptop
      type: object
      properties:
        $knn:
          oneOf:
          - $ref: '#/components/schemas/KnnPropositionObject'
          - $ref: '#/components/schemas/KnnPropositionArray'
    NnExplanation:
      type: object
      properties:
        $nn:
          type: object
          properties:
            near:
              type: array
              items:
                $ref: '#/components/schemas/PropositionExplanation'
    ScoreOperator:
      example: $p
      examples:
      - $p
      - $similarity
      - $multiply:
        - $p
        - margin
      oneOf:
      - $ref: '#/components/schemas/PlainProbability'
      - $ref: '#/components/schemas/Frequency'
      - $ref: '#/components/schemas/PlainLift'
      - $ref: '#/components/schemas/PlainSimilarity'
      - $ref: '#/components/schemas/PlainSameness'
      - $ref: '#/components/schemas/Hit'
      - $ref: '#/components/schemas/ProbabilityScore'
      - $ref: '#/components/schemas/ParametricProbabilityScore'
      - $ref: '#/components/schemas/LiftScore'
      - $ref: '#/components/schemas/ParametricLiftScore'
      - $ref: '#/components/schemas/ContextFrequencyScore'
      - $ref: '#/components/schemas/MeanScore'
      - $ref: '#/components/schemas/MinScore'
      - $ref: '#/components/schemas/MaxScore'
      - $ref: '#/components/schemas/ImpactScore'
      - $ref: '#/components/schemas/FreqP'
      - $ref: '#/components/schemas/Decision'
      - $ref: '#/components/schemas/SimilarityScore'
      - $ref: '#/components/schemas/SamenessScore'
      - $ref: '#/components/schemas/AnalogyScore'
      - $ref: '#/components/schemas/Multiply'
      - $ref: '#/components/schemas/Divide'
      - $ref: '#/components/schemas/Sum'
      - $ref: '#/components/schemas/Subtract'
      - $ref: '#/components/schemas/Pow'
      - $ref: '#/components/schemas/Normalize'
    ParametricHighlight:
      example:
        $highlight:
          posPreTag: <b>
          posPostTag: </b>
          negPreTag: <em>
          negPostTag: </em>
          encoder: html
      type: object
      properties:
        $highlight:
          type: object
          properties:
            posPreTag:
              type: string
            posPostTag:
              type: string
            negPreTag:
              type: string
            negPostTag:
              type: string
            posThreshold:
              type: number
            negThreshold:
              type: number
            encoder:
              type: string
    ValueField:
      example: $value
      type: string
      enum:
      - $value
    InverseDocumentFrequencyExplanation:
      example:
        type: idf
        value: 1.7551720221592049
      type: object
      required:
      - type
      - value
      properties:
        type:
          description: 'The explanation type: idf.

            '
          enum:
          - idf
          type: string
        value:
          description: 'The inverse document frequency score.

            '
          type: number
    FromTablequery:
      example: impressions
      examples:
      - impressions
      - products
      - customers
      - messages
      type: string
    Exists:
      example:
        $exists:
        - query
        - product.tags
      examples:
      - $exists:
        - query
        - product.tags
      - from: impressions
        where:
          $on:
          - $exists:
            - query
            - customer.tags
          - click: true
        relate:
        - product.title
        - product.tags
      type: object
      properties:
        $exists:
          $ref: '#/components/schemas/PropositionSet'
    StartsWithExplanation:
      type: object
      properties:
        $startsWith:
          type: string
    StartsWith:
      example:
        $startsWith: Cucumber
      examples:
      - $startsWith: Cucumber
      - from: products
        where:
          name:
            $startsWith: Cucumber
      type: object
      properties:
        $startsWith:
          oneOf:
          - $ref: '#/components/schemas/ToString'
          - $ref: '#/components/schemas/GetValueExpression'
          - type: string
    PropositionExplanation:
      oneOf:
      - $ref: '#/components/schemas/FieldPropositionExplanation'
      - $ref: '#/components/schemas/HasExplanation'
      - $ref: '#/components/schemas/AndExplanation'
      - $ref: '#/components/schemas/OrExplanation'
      - $ref: '#/components/schemas/OnExplanation'
      - $ref: '#/components/schemas/NotExplanation'
      - $ref: '#/components/schemas/StartsWithExplanation'
      - $ref: '#/components/schemas/GtExplanation'
      - $ref: '#/components/schemas/GteExplanation'
      - $ref: '#/components/schemas/LtExplanation'
      - $ref: '#/components/schemas/LteExplanation'
      - $ref: '#/components/schemas/DefinedExplanation'
      - $ref: '#/components/schemas/NumericExplanation'
      - $ref: '#/components/schemas/KnnExplanation'
      - $ref: '#/components/schemas/NnExplanation'
      - $ref: '#/components/schemas/IsPropositionExplanation'
    ScoreExplanation:
      example:
        type: baseP
        value: 0.28
      oneOf:
      - $ref: '#/components/schemas/SumExplanation'
      - $ref: '#/components/schemas/SubtractionExplanation'
      - $ref: '#/components/schemas/ProductExplanation'
      - $ref: '#/components/schemas/DivisionExplanation'
      - $ref: '#/components/schemas/BaseProbabilityExplanation'
      - $ref: '#/components/schemas/RelatedPropositionLiftExplanation'
      - $ref: '#/components/schemas/HitLinkPropositionLiftExplanation'
      - $ref: '#/components/schemas/DecoratedScoreExplanation'
      - $ref: '#/components/schemas/HitPropositionLiftExplanation'
      - $ref: '#/components/schemas/ConstantExplanation'
      - $ref: '#/components/schemas/DefaultValueExplanation'
      - $ref: '#/components/schemas/RegressionExplanation'
      - $ref: '#/components/schemas/NamedExplanation'
      - $ref: '#/components/schemas/BaseLiftExplanation'
      - $ref: '#/components/schemas/PredictExplanation'
      - $ref: '#/components/schemas/ExponentExplanation'
      - $ref: '#/components/schemas/TermFrequencyExplanation'
      - $ref: '#/components/schemas/InverseDocumentFrequencyExplanation'
      - $ref: '#/components/schemas/ExponentialExplanation'
      - $ref: '#/components/schemas/LogarithmicExplanation'
      - $ref: '#/components/schemas/WeightedAverageExplanation'
      - $ref: '#/components/schemas/NeighborContextExplanation'
      - $ref: '#/components/schemas/FieldExplanation'
      - $ref: '#/components/schemas/NoneExplanation'
    Lte:
      example:
        $lte: 8
      examples:
      - $lte: 8
      - $lte: 0
      - $lte: '20180502'
      - from: products
        where:
          price:
            $lte: 1
      type: object
      properties:
        $lte:
          oneOf:
          - $ref: '#/components/schemas/GetValueExpression'
          - type: integer
            format: int32
          - type: integer
            format: int64
          - type: number
          - type: 'null'
          - $ref: '#/components/schemas/ArrayValue'
          - $ref: '#/components/schemas/ToString'
          - type: boolean
          - type: string
          - $ref: '#/components/schemas/Json'
    SortField:
      example: $sort
      type: string
      enum:
      - $sort
    AnyQuery:
      oneOf:
      - $ref: '#/components/schemas/SimilarityQuery'
      - $ref: '#/components/schemas/PredictQuery'
      - $ref: '#/components/schemas/RecommendQuery'
      - $ref: '#/components/schemas/MatchQuery'
      - $ref: '#/components/schemas/RelateQuery'
      - $ref: '#/components/schemas/Query'
      - $ref: '#/components/schemas/SearchQuery'
    IndexField:
      example: $index
      type: string
      enum:
      - $index
    RegressionExplanation:
      example:
        operation: reduction
        proposition:
          category: dairy
        regressionType: categorical
        residual: null
        type: regression
        value: -0.234
      examples:
      - operation: reduction
        proposition:
          category: dairy
        regressionType: categorical
        residual: null
        type: regression
        value: -0.234
      - operation: reduction
        proposition:
          sale_price: 20.0
        regressionType: linear
        residual: 2.427
        type: regression
        value: -0.234
      type: object
      required:
      - type
      - proposition
      - value
      - regressionType
      - operation
      properties:
        type:
          description: 'The explanation type: regression.

            '
          enum:
          - regression
          type: string
        proposition:
          description: 'The field-value proposition that triggered this regression adjustment.

            '
          $ref: '#/components/schemas/PropositionExplanation'
        value:
          description: 'The regression effect/contribution to the score.

            '
          type: number
        regressionType:
          description: 'The type of regression: ''categorical'' (group effects) or ''linear'' (OLS).

            '
          type: object
        residual:
          description: 'For linear regression: the predictor''s residual value after its own transformation pipeline.

            '
          type: number
        operation:
          description: 'The operation: ''reduction'' (removing effect) or ''restoration'' (adding effect back).

            '
          type: object
    Frequency:
      example: $f
      examples:
      - $f
      - from: impressions
        get: product
        orderBy: $f
      type: string
      enum:
      - $f
    PropositionSet:
      example: product.tags
      examples:
      - product.tags
      - query
      - product
      - tags
      oneOf:
      - type: array
        items:
          $ref: '#/components/schemas/PropositionSet'
      - type: string
      - $ref: '#/components/schemas/Proposition'
    MatchesProjection:
      example: $matches
      type: string
      enum:
      - $matches
    ProbabilityScore:
      example:
        $p: tags
      examples:
      - $p: tags
      - $p:
        - tags
        - title
      - $p:
          $context:
            click: true
      - from: impressions
        where:
          product.title:
            $match: iphone
        get: product
        orderBy:
          $p: tags
      - from: impressions
        where:
          product.title:
            $match: iphone
        get: product
        orderBy:
          $p:
          - tags
          - title
      - from: impressions
        where:
          product.title:
            $match: iphone
        get: product
        orderBy:
          $p:
            $context:
              click: true
      type: object
      properties:
        $p:
          $ref: '#/components/schemas/PropositionSet'
    ParametricProbabilityScore:
      example:
        $probability:
          of: tags
      examples:
      - $probability:
          of: tags
      - $probability:
          of:
          - tags
          - title
      - $probability:
          of:
            $context:
              click: true
          basedOn:
          - title
          - tags
          - category
      - from: impressions
        where:
          product.title:
            $match: iphone
        get: product
        orderBy:
          $probability:
            of: tags
      type: object
      properties:
        $probability:
          type: object
          properties:
            of:
              $ref: '#/components/schemas/PropositionSet'
            basedOn:
              $ref: '#/components/schemas/PropositionSet'
    HighlightParams:
      type: object
      example:
        encoder: html
        negPostTag: </em>
        negPreTag: <em>
        negThreshold: 0.9
        posPostTag: </b>
        posPreTag: <b>
        posThreshold: 1.1
      properties:
        posPreTag:
          example: <b>
          type: string
        posPostTag:
          example: </b>
          type: string
        negPreTag:
          example: <em>
          type: string
        negPostTag:
          example: </em>
          type: string
        posThreshold:
          example: 1.1
          type: number
        negThreshold:
          example: 0.9
          type: number
        encoder:
          example: html
          type: string
    AndExplanation:
      type: object
      properties:
        $and:
          type: array
          items:
            $ref: '#/components/schemas/PropositionExplanation'
    'On':
      example:
        $on:
          prop:
            click: true
          'on':
            user.tags: nyc
      examples:
      - $on:
          prop:
            click: true
          'on':
            user.tags: nyc
      - $on:
        - click: true
        - user.tags: nyc
      type: object
      properties:
        $on:
          oneOf:
          - $ref: '#/components/schemas/OnPropositionObject'
          - $ref: '#/components/schemas/OnPropositionArray'
    EstimateResult:
      example:
        name: My product
        price: 172.19
      examples:
      - name: My product
        price: 172.19
      - $score: 0.22350516297675496
        $value: coffee
        $why:
          factors:
          - factors:
            - proposition:
                name:
                  $has: coffee
              type: relatedPropositionLift
              value: 8.45603245079726
            proposition: coffee
            type: hitPropositionLift
            value: 8.45603245079726
          type: product
      oneOf:
      - $ref: '#/components/schemas/UserDefinedObject'
      - $ref: '#/components/schemas/PropositionExplanation'
      - type: object
      - $ref: '#/components/schemas/ScoreExplanation'
    SimilarityQuery:
      type: object
      example:
        from: impressions
        lim

# --- truncated at 32 KB (102 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/aito-technologies/refs/heads/main/openapi/aito-technologies-query-api-openapi.yml