Build with Confidence
A reliable, well-documented API with sub-50ms latency, 99.99% uptime, and everything you need to deliver exceptional search experiences.
API at a Glance
Search and Discovery
POST /v1/search
POST /v1/multi-search
POST /v1/filters
GET /v1/filters/schema
POST /v1/filters/{facet}/values
Query Suggestions
GET /v1/suggestions/queries
POST /v1/suggestions/queries
GET /v1/suggestions/config
Store Management
GET/PUT /api/v1/stores/{id}/config
GET/POST /api/v1/stores/{id}/schema
POST /api/v1/stores/{id}/documents
POST /api/v1/stores/{id}/documents/bulk
Analytics
POST /analytics/event
POST /analytics/batch
POST /analytics/validate
GET /analytics/schema
Simple Header-Based Auth
Every request uses three headers for authentication. Read operations require your Store ID and read secret. Write operations use a separate write secret for additional security.
Your unique Store ID
Read-only secret
Write operations secret
curl -X POST https://api.seekora.ai/v1/search \ -H "x-storeid: your-store-id" \ -H "x-storesecret: your-read-secret" \ -H "Content-Type: application/json" \ -d '{"query": "blue sneakers"}'
Sub-50ms
P99 Latency
99.99%
Uptime
Global
Edge Network
Full OpenAPI Specification
Download or browse our complete OpenAPI 3.0 specification. Import it into Postman, generate client libraries, or explore every endpoint interactively.
Official SDK Packages
@seekora-ai/search-sdk
Core search client for Node.js and browser environments.
@seekora-ai/react-sdk
React hooks and components for building search UIs.
@seekora-ai/autocomplete
Drop-in autocomplete widget with keyboard navigation.
API Questions Answered
Common questions about our API, authentication, and SDKs.
What are the API rate limits?
Free-tier accounts get 1,000 requests per minute. Paid plans scale to 50,000+ requests per minute with burst allowances. Contact us for enterprise-grade limits.
How does authentication work?
Every request requires an x-storeid header. Read operations use x-storesecret, while write operations use x-store-write-secret. Keys are generated in the dashboard.
Is the API versioned?
Yes. The current stable version is v1, accessible at /v1/ endpoints. We follow semantic versioning and provide migration guides for any breaking changes.
How should I handle errors?
The API returns standard HTTP status codes. 4xx errors include a JSON body with a message field explaining the issue. 5xx errors are retryable with exponential backoff.
Do you support webhooks?
Yes. You can configure webhooks in the dashboard to receive notifications for indexing events, schema changes, and analytics thresholds.
Which SDKs are available?
We offer official SDKs for JavaScript/TypeScript (Node.js and browser), React, and a REST-compatible client for any language. Community SDKs are available for Python and Go.
Start Building Today.
The Seekora search engine works for you 24/7. Discover what's new and why our AI is unique.