# Поиск · Search API — neuraldeep.ru API

> Раздел машиночитаемой справки. Все разделы: https://neuraldeep.ru/llms.txt · всё одним файлом: https://neuraldeep.ru/llms-full.txt

Base URL: `https://api.neuraldeep.ru/v1`
Auth: `Authorization: Bearer $YOUR_KEY`

Тем же ключом — поиск по Telegram и нашей базе ТГ-каналов, поиск по интернету, чтение страницы по ссылке и краулинг сайтов. Эндпоинты под `/v1/search/*`. Доступно на **всех тарифах, включая free** (кроме API-only тарифа Coder), с отдельным от чата лимитом.

Две корзины лимитов: **поиск** (ТГ + база каналов + интернет + чтение страниц) и **краулинг** (отдельно — он тяжелее). Текущий остаток: `GET /v1/search/quota` или карточка «Search API» в дашборде. Каждый ответ поиска тоже несёт поле `quota` с остатком дня и месяца. При исчерпании придёт `429` с телом `quota_exceeded` и `Retry-After`.

**Запрос и ошибки.** `POST /v1/search/web` требует поле `query`, `POST /v1/search/read` и `POST /v1/search/crawl` требуют `url`, тело должно быть JSON-объектом. Без обязательного поля придёт `400`. Ответ должен уложиться в 60 секунд. Если поиск или чтение страницы временно недоступны, придёт `503`, при сбое на нашей стороне `502`. У ключа в режиме «Кошелёк» с пустым балансом `402`.

```bash
# наша база Telegram-каналов (vector + full-text)
curl "https://api.neuraldeep.ru/v1/search/tg?q=AI-агенты&limit=5" \
  -H "Authorization: Bearer $YOUR_KEY"

# поиск по интернету
curl https://api.neuraldeep.ru/v1/search/web \
  -H "Authorization: Bearer $YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"query":"свежие новости про LLM","limit":3}'
```

```bash
# чистый markdown одной страницы ("return_format":"text" для плоского текста)
curl https://api.neuraldeep.ru/v1/search/read \
  -H "Authorization: Bearer $YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
```

```bash
# обойти сайт (несколько страниц)
curl https://api.neuraldeep.ru/v1/search/crawl \
  -H "Authorization: Bearer $YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","limit":3}'

# сколько осталось по обеим корзинам
curl https://api.neuraldeep.ru/v1/search/quota \
  -H "Authorization: Bearer $YOUR_KEY"
```

```python
import httpx

r = httpx.get(
    "https://api.neuraldeep.ru/v1/search/tg",
    params={"q": "RAG в проде", "limit": 5},
    headers={"Authorization": "Bearer $YOUR_KEY"},
)
data = r.json()
for item in data.get("results", []):
    print(item.get("channel"), "—", item.get("text", "")[:120])
print("остаток:", data.get("quota", {}).get("day"))
```

> web-поиск и краулинг тратят реальные деньги провайдеров, поэтому у них отдельная (более скромная) корзина. ТГ-поиск по нашей базе — дешёвый, лимит щедрее.