API Overview

Base URL

All API requests should be made to:

This endpoint requires Bearer token authentication.

Authentication

The AI Search API uses Bearer tokens for authentication. Include your Bearer token in the Authorization header.

• Bearer tokens are project-specific and must be active to function
• Each project has separate Bearer tokens for different services
• Keep your Bearer tokens secure and never share them publicly
• Different subscription plans have different usage limits
• Tokens are validated against the Supabase database and update last_used_at on each request

Request Format

The API accepts JSON requests with the following characteristics:

Error Handling

The API uses standard HTTP status codes to indicate success or failure:

Error Response Format

Error responses follow this format:

Error Examples

{
  "detail": "Bearer token is required",
  "headers": {
    "WWW-Authenticate": "Bearer"
  }
}

{
  "detail": "Searches limit exceeded. Upgrade your plan to continue searching."
}

{
  "detail": "search_type must be 'keyword' or 'hybrid'"
}

Rate Limits

API usage is limited based on your subscription plan:

• Rate limits are applied per Bearer token
• Limits vary by subscription tier
• Usage is tracked automatically
• Contact support if you need higher limits

Security

Do not use this API for client-side calls as you will be exposing your API key.