Начало работы

Быстрый старт

Сделайте первый запрос к API srezai.ru за пару минут. Ниже — рабочий пример веб-поиска на трёх языках.

1. Получите API-ключ#

Войдите в личный кабинет и создайте ключ в разделе «API-ключи». Ключ показывается один раз при создании — сохраните его. Все ключи начинаются с префикса srz_live_. Подробнее — в разделе Аутентификация.

При регистрации — бонус

Новым аккаунтам начисляется 100 ₽ на счёт — это около 1 000 запросов на знакомство с API. Месячных квот нет: платите только за фактически выполненные запросы. Попробовать поиск без ключа можно прямо в личном кабинете — программный API /api/v1/* всегда требует ключ.

2. Первый запрос#

Отправьте POST-запрос на /api/v1/search с заголовком Authorization. Обязательное поле — query; остальные параметры необязательны.

curl -X POST https://srezai.ru/api/v1/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer srz_live_ВАШ_КЛЮЧ" \
  -d '{
    "query": "новости искусственного интеллекта",
    "category": "news",
    "language": "ru"
  }'

3. Разберите ответ#

Ответ приходит в JSON: массив results с чистыми результатами, подсказки, прямые ответы и метаданные meta с временем и количеством результатов.

json
{
  "query": "новости искусственного интеллекта",
  "results": [
    {
      "title": "…",
      "url": "https://…",
      "content": "Краткое описание страницы…",
      "engine": "yandex",
      "source": "example.ru",
      "score": 1.42,
      "relevance": 0.87,
      "publishedDate": "2026-07-21T09:00:00"
    }
  ],
  "answers": [],
  "suggestions": ["…"],
  "meta": { "total": 12, "tookMs": 640, "rawBytes": 84210, "cleanBytes": 5120 }
}

Что дальше#