На этой странице

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

Сделайте первый запрос к API srezai.ru за пару минут: поставьте SDK, передайте ключ и получите чистые результаты поиска.

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

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

2. Установите SDK

Официальные клиенты берут на себя заголовки, разбор ошибок и повторы при лимитах. Ставить их не обязательно - API это обычный REST, и пример на cURL ниже работает без установки.

bash
pip install srezai

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

Обязательное поле одно - query. Остальное необязательно: category сужает выдачу до новостей, IT или научных публикаций, language и timeRange - до языка и свежести.

python
from srezai import SrezAI

# Ключ можно не передавать: подхватится из SREZAI_API_KEY
client = SrezAI(api_key="srz_live_ВАШ_КЛЮЧ")

res = client.search("новости искусственного интеллекта", category="news")
for r in res["results"]:
    print(r["title"], "-", r["url"])

4. Разберите ответ

Ответ приходит в 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 }
}

Что дальше

SDK и исходники

Клиенты для Python и JavaScript лежат в одном репозитории srezai-sdk под лицензией MIT: семь методов API, отдельный класс исключения на каждую ошибку и повторы там, где они осмысленны. Пакеты - PyPI и npm.