Skip to main content

​
Base URL

All production requests use: 
https://api.kanarie.xyz

​
Authenticate

Pass your API key as a Bearer token. 
Authorization: Bearer YOUR_API_KEY
The x-kanarie-api-key: YOUR_API_KEY header is also supported for current clients.

​
Search content

This request searches recent and semantic crypto content across Kanarie’s content index. 
curl -X POST "https://api.kanarie.xyz/api/v1/content/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_mode": "semantic",
    "query": "latest DeFi trends on Solana",
    "content_types": ["posts", "tweets", "news"],
    "ecosystems": ["solana"],
    "limit": 10,
    "include_analysis": true
  }'
Successful responses use a consistent envelope: 
{
  "success": true,
  "error": null,
  "content": [],
  "metadata": {
    "total_results": 0,
    "limit": 10
  }
}
Validation and authorization failures return success: false where the route owns the response body, or a shared error body from authentication and rate-limit middleware.

​
Use the playground

Open any endpoint in the API reference, paste your API key into the auth field, and click Send. The playground sends live requests to https://api.kanarie.xyz.
Some endpoints also support x402 payment fallback when no API key is present, API-key auth fails client-side checks, or an API-key request exceeds plan limits. The playground is configured for API-key usage as the primary path.