turbopuffer is a serverless search engine that combines vector and full-text (BM25) search built from first principles directly on object storage. It exposes a single REST API organized around namespaces — each namespace stores documents with vector embeddings, attributes, and full-text indexes — and supports approximate nearest neighbor, full-text BM25, and hybrid query patterns with attribute filtering, ranking, and aggregation. The platform is used in production by Anthropic, Cursor, Notion, Linear, Superhuman, Pylon, Readwise, and Telus, and handles 4T+ documents, 10M+ writes/s, and 25k+ queries/s across customer fleets. Official client libraries ship for Python, TypeScript, Go, Java, Ruby, and C#, generated from a public OpenAPI 3.1 specification via Stainless. Pricing is tiered (Launch, Scale, Enterprise) with usage-based metering on storage, writes, and queries on top of monthly minimums.
turbopuffer publishes 11 API contracts indexed on the APIs.io network, including Namespaces API, and 10 more. Tagged areas include Vector Search, Full-Text Search, Hybrid Search, BM25, and Serverless.
The turbopuffer catalog on APIs.io includes 1 Spectral governance ruleset.
turbopuffer’s developer surface includes authentication, documentation, GitHub presence, pricing, engineering blog, and 22 more developer resources.
48.0/100developing▬ flatAgent20/100agent awareFront door AI4/6
moderate
Heartbeat100/100
alive
open core · MIT
Full breakdown ↓
scored 2026-11-13 · rubric v0.28.0 · Show this score on your site →
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Open Source Surface applies to this provider. This product is open source and we
read its repository directly, so Open Source Surface carries
10 points of the composite. It is scored from what the repository actually
publishes — a security policy, a contribution guide, a release history, a code of conduct — read live from the
provider rather than inferred from our own catalog pointers.
This facet adds; nothing was taken away to make room for it. An open-source project is not excused from
the commercial facets, because exemption would strip it of the points it does earn.
If we have the wrong repository, or this product is not open source, say so on your
provider repo and we
will drop the facet rather than have you publish against it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 65 points between them,
because both conditional facets apply and carry
35 points together. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 65% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/turbopuffer/"><img src="https://apis.io/badge/turbopuffer/card.svg" alt="turbopuffer on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship Ask about this →
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented) Ask about this →
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes Ask about this →
Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.
Not sure how this applies to your stack? Ask about any one item. Kin Lane reads every question, looks at your profile and your situation, and replies with what a fix would take — scoped to that one area, priced up front, yours whether you ship it or not. Ask a question →
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
Endpoints for upserting, patching, and deleting documents within a namespace. Writes are batched into a per-namespace write-ahead log and become queryable once committed to obje...
Unified query endpoint that runs vector ANN, full-text BM25, and hybrid queries against a namespace, with attribute filters, top-k, aggregation groups, and ranking controls. Sup...
aid: turbopuffer
url: https://raw.githubusercontent.com/api-evangelist/turbopuffer/refs/heads/main/apis.yml
name: turbopuffer
kind: company
description: turbopuffer is a serverless search engine that combines vector and full-text (BM25) search built from first principles
directly on object storage. It exposes a single REST API organized around namespaces — each namespace stores documents with
vector embeddings, attributes, and full-text indexes — and supports approximate nearest neighbor, full-text BM25, and hybrid
query patterns with attribute filtering, ranking, and aggregation. The platform is used in production by Anthropic, Cursor,
Notion, Linear, Superhuman, Pylon, Readwise, and Telus, and handles 4T+ documents, 10M+ writes/s, and 25k+ queries/s across
customer fleets. Official client libraries ship for Python, TypeScript, Go, Java, Ruby, and C#, generated from a public
OpenAPI 3.1 specification via Stainless. Pricing is tiered (Launch, Scale, Enterprise) with usage-based metering on storage,
writes, and queries on top of monthly minimums.
deliveryModel:
model: open-core
license: MIT
open_source: true
commercial: true
callable_host: true
label: Open core · an OSS project plus a commercial hosted product
confidence: high
source:
- license
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: paid
onboarding: unknown
trial: false
try_now: false
public: false
label: Paid
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-13'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/turbopuffer.png
tags:
- Vector Search
- Full-Text Search
- Hybrid Search
- BM25
- Serverless
- Object Storage
- RAG
- Semantic Search
- AI Infrastructure
- Embeddings
created: '2026-05-23'
modified: '2026-05-25'
specificationVersion: '0.23'
apis:
- aid: turbopuffer:write
name: turbopuffer Write API
description: Endpoints for upserting, patching, and deleting documents within a namespace. Writes are batched into a per-namespace
write-ahead log and become queryable once committed to object storage. Supports both row-oriented and column-oriented
batch formats.
humanURL: https://turbopuffer.com/docs/write
baseURL: https://api.turbopuffer.com
tags:
- Namespaces
tags_raw:
- Write
- Upsert
- Namespaces
properties:
- type: Documentation
url: https://turbopuffer.com/docs/write
- aid: turbopuffer:query
name: turbopuffer Query API
description: Unified query endpoint that runs vector ANN, full-text BM25, and hybrid queries against a namespace, with attribute
filters, top-k, aggregation groups, and ranking controls. Supports multi-query (up to 16 per request) and explain_query
for query planning.
humanURL: https://turbopuffer.com/docs/query
baseURL: https://api.turbopuffer.com
tags:
- Query
- Vectors
- BM25
- Hybrid
- ANN
tags_raw:
- Query
- Vector
- BM25
- Hybrid
- ANN
properties:
- type: Documentation
url: https://turbopuffer.com/docs/query
- aid: turbopuffer:namespaces
name: turbopuffer Namespaces API
description: Namespace lifecycle and metadata endpoints — list namespaces, read schema / dimensions / row count, warm the
cache, export contents, branch_from (copy-on-write clones in constant time), copy_from, and delete a namespace.
humanURL: https://turbopuffer.com/docs/namespaces
baseURL: https://api.turbopuffer.com
tags:
- Namespaces
- Metadata
- Admin
- Branching
properties:
- type: Documentation
url: https://turbopuffer.com/docs/namespaces
- aid: turbopuffer:python-sdk
name: turbopuffer Python SDK
description: Official Python client library for the turbopuffer REST API, Stainless-generated from the public OpenAPI spec.
humanURL: https://github.com/turbopuffer/turbopuffer-python
baseURL: https://github.com/turbopuffer/turbopuffer-python
tags:
- SDK
- Python
properties:
- type: Repository
url: https://github.com/turbopuffer/turbopuffer-python
- type: Package
url: https://pypi.org/project/turbopuffer/
- aid: turbopuffer:typescript-sdk
name: turbopuffer TypeScript SDK
description: Official TypeScript / JavaScript client library for the turbopuffer REST API, Stainless-generated and published
to npm.
humanURL: https://github.com/turbopuffer/turbopuffer-typescript
baseURL: https://github.com/turbopuffer/turbopuffer-typescript
tags:
- SDK
- TypeScript
- JavaScript
properties:
- type: Repository
url: https://github.com/turbopuffer/turbopuffer-typescript
- type: Package
url: https://www.npmjs.com/package/@turbopuffer/turbopuffer
- aid: turbopuffer:go-sdk
name: turbopuffer Go SDK
description: Official Go client library for the turbopuffer REST API, Stainless-generated from the public OpenAPI spec.
humanURL: https://github.com/turbopuffer/turbopuffer-go
baseURL: https://github.com/turbopuffer/turbopuffer-go
tags:
- SDK
- Go
properties:
- type: Repository
url: https://github.com/turbopuffer/turbopuffer-go
- aid: turbopuffer:java-sdk
name: turbopuffer Java SDK
description: Official Java / Kotlin client library for the turbopuffer REST API, Stainless-generated from the public OpenAPI
spec.
humanURL: https://github.com/turbopuffer/turbopuffer-java
baseURL: https://github.com/turbopuffer/turbopuffer-java
tags:
- SDK
- Java
- Kotlin
properties:
- type: Repository
url: https://github.com/turbopuffer/turbopuffer-java
- aid: turbopuffer:ruby-sdk
name: turbopuffer Ruby SDK
description: Official Ruby client library for the turbopuffer REST API, Stainless-generated from the public OpenAPI spec.
humanURL: https://github.com/turbopuffer/turbopuffer-ruby
baseURL: https://github.com/turbopuffer/turbopuffer-ruby
tags:
- SDK
- Ruby
properties:
- type: Repository
url: https://github.com/turbopuffer/turbopuffer-ruby
- aid: turbopuffer:csharp-sdk
name: turbopuffer C# SDK
description: Official C# / .NET client library for the turbopuffer REST API, Stainless-generated from the public OpenAPI
spec.
humanURL: https://github.com/turbopuffer/turbopuffer-csharp
baseURL: https://github.com/turbopuffer/turbopuffer-csharp
tags:
- SDK
- C#
- .NET
tags_raw:
- SDK
- CSharp
- DotNet
- Dotnet
properties:
- type: Repository
url: https://github.com/turbopuffer/turbopuffer-csharp
- aid: turbopuffer:benchmark
name: tpuf-benchmark
description: Open-source general-purpose benchmarking tool for turbopuffer deployments. Useful for validating recall, latency,
and throughput on a given workload.
humanURL: https://github.com/turbopuffer/tpuf-benchmark
baseURL: https://github.com/turbopuffer/tpuf-benchmark
tags:
- Tooling
- Benchmarks
- Go
tags_raw:
- Tooling
- Benchmark
- Go
properties:
- type: Repository
url: https://github.com/turbopuffer/tpuf-benchmark
- aid: turbopuffer:turbopuffer-namespaces-api
name: turbopuffer Namespaces API
description: The Namespaces API from turbopuffer — 12 operation(s) for namespaces.
humanURL: https://turbopuffer.com/docs
baseURL: https://api.turbopuffer.com
tags:
- Namespaces
properties:
- type: OpenAPI
url: openapi/turbopuffer-namespaces-api-openapi.yml
- type: Documentation
url: https://turbopuffer.com/docs
- type: Authentication
url: https://turbopuffer.com/docs/auth
- type: GettingStarted
url: https://turbopuffer.com/docs/quickstart
- type: OpenAPI-Source
url: https://github.com/turbopuffer/turbopuffer-openapi
common:
- type: Plans
url: plans/turbopuffer-plans-pricing.yml
- type: RateLimits
url: rate-limits/turbopuffer-rate-limits.yml
- type: FinOps
url: finops/turbopuffer-finops.yml
- type: IssueTracker
url: https://github.com/turbopuffer/turbopuffer-python/issues
- type: Releases
url: https://github.com/turbopuffer/turbopuffer-python/releases
- type: SecurityPolicy
url: https://github.com/turbopuffer/turbopuffer-python/blob/main/SECURITY.md
- type: ContributionGuide
url: https://github.com/turbopuffer/turbopuffer-python/blob/main/CONTRIBUTING.md
- type: License
name: MIT
url: https://github.com/turbopuffer/turbopuffer-python/blob/main/LICENSE
- type: AgenticAccess
url: agentic-access/turbopuffer-agentic-access.yml
- type: DomainSecurity
url: security/turbopuffer-domain-security.yml
- type: Authentication
url: authentication/turbopuffer-authentication.yml
- type: Website
url: https://turbopuffer.com/
- type: Documentation
url: https://turbopuffer.com/docs
- type: GitHub
url: https://github.com/turbopuffer
- type: OpenAPI
url: https://github.com/turbopuffer/turbopuffer-openapi
- type: Pricing
url: https://turbopuffer.com/pricing
- type: Architecture
url: https://turbopuffer.com/docs/architecture
- type: Regions
url: https://turbopuffer.com/docs/regions
- type: Limits
url: https://turbopuffer.com/docs/limits
- type: Blog
url: https://turbopuffer.com/blog
- type: LlmsText
url: https://turbopuffer.com/llms.txt
- type: TermsOfService
url: https://turbopuffer.com/terms-of-service
- type: Customers
url: https://turbopuffer.com/customers
- type: UsageTerms
url: terms/turbopuffer-terms-of-service.yml
- type: Eligibility
url: eligibility/turbopuffer-eligibility.yml
- type: AIPreferences
url: ai-preferences/turbopuffer-ai-preferences.yml
- type: DataLicense
url: data-license/turbopuffer-data-license.yml
integrations:
- name: Anthropic
description: Anthropic is a publicly listed turbopuffer customer, using the platform as serverless vector + full-text search
infrastructure for AI workloads alongside Anthropic's Claude model family.
url: https://turbopuffer.com/
- name: Cursor
description: Cursor uses turbopuffer at >1T vectors and 80M+ namespaces to power semantic code retrieval inside the Cursor
AI coding environment, reporting up to 23.5% improvement in agent accuracy and a 20x cost reduction versus prior infrastructure.
url: https://turbopuffer.com/customers/cursor
- name: Notion
description: Notion uses turbopuffer as the search backbone for workspace content across its customer base.
url: https://turbopuffer.com/customers/notion
- name: Linear
description: Linear uses turbopuffer to power search across issues, projects, and docs at scale.
url: https://turbopuffer.com/customers/linear
- name: Superhuman
description: Superhuman uses turbopuffer as part of its AI-assisted email search and retrieval stack.
url: https://turbopuffer.com/customers
- name: Stainless
description: Stainless generates turbopuffer's official client libraries (Python, TypeScript, Go, Java, Ruby, C#) directly
from the public OpenAPI 3.1 specification.
url: https://www.stainless.com/
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
turbopuffer API — frequently asked questions
Does turbopuffer have an API?
Yes. APIs.io lists 11 APIs from turbopuffer, including turbopuffer Write API, turbopuffer Query API and turbopuffer Namespaces API, and 8 more.
Is there an OpenAPI specification for the turbopuffer API?
Yes. APIs.io indexes 1 OpenAPI specification for turbopuffer, each linked for download from this page.
How do I authenticate with the turbopuffer API?
turbopuffer uses bearer-token authentication (http · 1 scheme). The details are profiled on APIs.io as turbopuffer Authentication.
How much does the turbopuffer API cost?
turbopuffer publishes its prices; its launch plan is $16/month minimum usage as of 2026-10-28. APIs.io lists 4 pricing plans for turbopuffer, with each plan's price, limits and inclusions under Pricing on this page.
Is the turbopuffer API ready for AI agents?
turbopuffer has a Kin Score of 48.0 out of 100 (developing) and an Agent Readiness score of 19.6 (agent-aware), scored by API Evangelist on 2026-11-13.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.