Быстрый старт REST API: первый запрос за пять минут

От регистрации до первого ответа API — несколько минут. Понадобятся аккаунт на seyka.ru, API-ключ и положительный баланс.

1. Зарегистрируйтесь на seyka.ru.

   Войдите через Яндекс или VK на seyka.ru. Анонимного доступа к API нет.

2. Создайте API-ключ.

   На странице seyka.ru/api-keys создайте ключ и сразу скопируйте его — полностью он показывается один раз. Сохраните ключ в переменной окружения:

   export SEYKA_API_KEY='sk_...'

   Тот же ключ открывает и MCP-сервер. Про хранение и отзыв ключей — в разделе Аутентификация.

3. Проверьте ключ.

   GET /v1/me бесплатен и отвечает, кому принадлежит ключ:

   curl https://proxy.seyka.ru/v1/me \
     -H "Authorization: Bearer $SEYKA_API_KEY"

   Ответ 401 значит, что ключ скопирован не полностью, отозван или истёк.

4. Пополните баланс.

   Вызовы оплачиваются поштучно с баланса аккаунта, без абонентской платы. Пополнить баланс можно на той же странице seyka.ru/api-keys; цена каждого вызова — в таблице цен.

5. Сделайте первый запрос.

   Например, геолокация IP-адреса:

   curl https://proxy.seyka.ru/v1/ipinfo/8.8.8.8 \
     -H "Authorization: Bearer $SEYKA_API_KEY"

   {
     "ip": "8.8.8.8",
     "city": "Mountain View",
     "region": "California",
     "country": "US",
     "loc": "37.4056,-122.0775",
     "org": "AS15169 Google LLC",
     "postal": "94043",
     "timezone": "America/Los_Angeles"
   }

   Примеры на TypeScript, Python и Go — в разделе Аутентификация.

Что дальше

Обзор APIБазовый URL, сервисы и машиночитаемая спецификация OpenAPI.

Ошибки и повторыКоды ответа, формат ошибки и какие запросы можно повторять.

Поиск ЯндексаВеб-поиск Яндекса: умный режим, пакеты, Brave- и Tavily-совместимые форматы.

Подключить ИИ-агентаТе же инструменты и аналитика Метрики, Вебмастера, GSC и GA4 — через MCP-сервер.