Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

kapa.ai Retrieval API

Semantic retrieval and keyword search.

kapa.ai Retrieval API is one of 6 APIs that kapa.ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Retrieval. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 4 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against a single base URL, https://api.kapa.ai.

2 operations 2 paths 4 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://api.kapa.ai/query/v1
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

kapa.ai Retrieval API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-KEY (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — kapa.ai project API key, created in the API Keys tab of the platform.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Retrieval 2

Semantic retrieval and keyword search.

POST
/query/v1/projects/{project_id}/retrieval
Retrieval
retrieval 1 param body → 200401
GET
/query/v1/projects/{project_id}/searchdeprecated
Search (deprecated)
search 2 params → 200401

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are RetrievedChunk (4 properties), RetrievalRequest (2 properties), RetrievalResponse (1 property), Error (1 property). Each schema is shown below with its type and property counts.

RetrievedChunk
object
4 properties
Error
object
1 property
RetrievalResponse
object
1 property
RetrievalRequest
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kapa-ai-retrieval-api-openapi.yml Raw ↑

Other APIs kapa.ai publishes across the network.

kapa.ai Analytics API
kapa.ai Chat API
kapa.ai Feedback API
kapa.ai Projects API
kapa.ai Threads API