Search - Classify

Semantic search over the live index, billed when your search completes.

Request

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 to 20 and defaults to 20.

Response

{
  "query": "serious gear reviews read by in-market buyers",
  "results": [
    { "url": "https://www.example.com/ev-incentives",
      "title": "EV incentives explained",
      "description": "A short summary of the page." }
  ],
  "count": 1,
  "latency_ms": 640
}

results[] carries url, title, and description. title and description may be null. The response also returns query, count, and latency_ms. Your remaining balance travels in the X-Credits-Remaining header.

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.