Documentation
RunoxAI API
RunoxAI gives you access to the world's most powerful semantic search API. Build AI applications that understand what users mean, not just what they type.
🌐
Base URL
api.runoxai.com/v1
🔑
Auth
Bearer token
📄
Format
JSON
Authentication
All API requests require authentication using an API key. Include your key in the Authorization header.
Authorization: Bearer rx-your-api-key-here
Never expose your API key in client-side code. Always make API calls from your server.
Quick Start
Get up and running in under 5 minutes. Install the SDK, initialize the client, and make your first search.
400">class="text-white/30 italic"># Install the SDK
pip install runoxai
400">class="text-white/30 italic"># Initialize the client
400">import runoxai
client = runoxai.RunoxAI(api_key=400">class="text-emerald-400">"rx-your-key-here")
400">class="text-white/30 italic"># Your first search
results = client.search(
400">class="text-emerald-400">"What are the latest AI breakthroughs?",
num_results=5
)
400">for result in results:
400">print(f400">class="text-emerald-400">"Title: {result.title}")
400">print(f400">class="text-emerald-400">"URL: {result.url}")
400">print(f400">class="text-emerald-400">"Score: {result.score:.4f}")
400">print()API Endpoints
The RunoxAI API provides the following endpoints:
Search Parameters
| Parameter | Type | Description |
|---|---|---|
queryrequired | string | The search query. Can be a question, phrase, or keywords. |
numResults | number | Number of results to return. Default: 10, max: 100. |
type | string | "neural" or "keyword". Default: "neural". |
highlights | boolean | Return highlighted snippets. Default: false. |
livecrawl | string | "always", "fallback", or "never". Default: "never". |
startPublishedDate | string | Filter by publish date (ISO 8601). |
includeDomains | string[] | Only include results from these domains. |
excludeDomains | string[] | Exclude results from these domains. |
Rate Limits
Rate limits vary by plan. When you exceed the rate limit, the API returns a429status code with a Retry-After header.
Free
10 req/s
1K/mo
Starter
50 req/s
10K/mo
Pro
200 req/s
50K/mo
Enterprise
Custom
Unlimited