Quickstart

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.

Get started

Guides

Base URL

Authenticate

Search content

Use the playground

​Base URL

​Authenticate

​Search content

​Use the playground

Base URL

Authenticate

Search content

Use the playground