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

# Search

> Semantic search over the live Classify index.

Semantic search over the live index. 6 credits (\$1.50/1K) per query, billed when your search completes.

## Request

```bash theme={null}
curl -s -X POST https://api.classify.ai/v1/search \
  -H "Authorization: Bearer $CLASSIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "serious gear reviews read by in-market buyers", "limit": 10}'
```

`limit` is 1-20.

## Response

```json theme={null}
{
  "results": [
    { "url": "https://…", "title": "…", "description": "…" }
  ],
  "count": 1,
  "latency_ms": 42,
  "credits_remaining": 24994
}
```

`results[]` carries `url`, `title`, and `description`. `title` and `description` are best-effort and may be `null`. The response also returns `count`, `latency_ms`, and `credits_remaining`.

## Billing

A completed search bills when it completes, and a completed search with zero results still bills. A query we can't process (`422`) or an upstream failure (`503`) never bills.