> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kanarie.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first Kanarie API request.

## Base URL

All production requests use:

```bash theme={null}
https://api.kanarie.xyz
```

## Authenticate

Pass your API key as a Bearer token.

```bash theme={null}
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.

```bash theme={null}
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:

```json theme={null}
{
  "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](/api-reference/introduction), paste your API key into the auth field, and click **Send**. The playground sends live requests to `https://api.kanarie.xyz`.

<Note>
  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.
</Note>