Rankly API для продуктов и автоматизации

Сценарии использования

• Встроить аудит в свой продукт. Если вы разрабатываете CMS, редактор, клиентский кабинет или маркетинговый инструмент — API позволяет добавить SEO и GEO-анализ как нативную функцию. Пользователь вводит URL, вы получаете готовый отчёт и показываете его в своём интерфейсе.
• Автоматизировать проверки. Запускайте аудиты программно: перед публикацией, по расписанию, при обновлении страниц. Результаты сохраняйте в своей базе, триггерьте уведомления при падении скора или появлении новых проблем.
• Масштабировать работу агентства. Через API можно проверять сразу несколько страниц клиентов, собирать результаты в сводные отчёты, подключать к внутренним системам управления проектами и отслеживать динамику без ручных действий.
• Добавить AI-видимость как метрику. AI Visibility Score доступен через API так же, как и через веб. Выводите его рядом с позициями и трафиком в своих дашбордах — или используйте как сигнал в автоматических отчётах для клиентов.

Как устроен API

• Асинхронный режим для тяжёлых задач. SEO-аудит включает загрузку страницы, проверку Core Web Vitals и два прохода ИИ — это занимает время. Запрос возвращается немедленно с идентификатором задачи, а результат доступен по статусу. Без зависающих соединений и таймаутов.
• Синхронный режим для быстрых интеграций. Там, где нужен ответ в одном запросе — например, в браузерном расширении или мгновенной проверке — доступен синхронный режим. Один запрос, один ответ, полный отчёт.
• Структурированные JSON-контракты. Каждый ответ следует фиксированному контракту: скор, разбивка по группам сигналов, Core Web Vitals, данные Schema.org, рекомендации. Стабильная структура — никаких сюрпризов при парсинге.
• GEO-аудит через тот же интерфейс. GEO-аудит (AI Visibility) вызывается через тот же API с указанием режима. Результат включает оценку видимости в Google AI Overviews, Perplexity и Яндекс Нейро с конкретными рекомендациями.

Как начать работу

1. Зарегистрируйтесь и получите API-ключ в личном кабинете — он используется для аутентификации всех запросов.
2. Отправьте URL страницы на endpoint аудита. В ответ вы получите идентификатор задачи (асинхронный режим) или готовый отчёт (синхронный режим).
3. Когда аудит завершён, заберите результат по идентификатору. Статус задачи обновляется автоматически.
4. Используйте JSON-ответ в своём интерфейсе: рендерьте скор, показывайте проблемы, стройте динамику по времени.
5. При необходимости — настройте webhook, чтобы получать уведомление о завершении аудита без опроса статуса.

Кому подойдёт

• Продуктовым командам. Вы строите инструмент для маркетологов, редакторов или владельцев сайтов. Вместо того чтобы собирать собственный SEO-пайплайн, вы подключаете Rankly API и получаете готовый слой анализа.
• Разработчикам и интеграторам. Стабильные контракты, предсказуемые ответы, поддержка фонового режима. API спроектирован так, чтобы встраиваться в существующие системы без лишних усложнений.
• Агентствам с потоком клиентских проектов. Автоматизируйте рутинные проверки: запускайте аудиты из своих систем, собирайте отчёты программно и отслеживайте изменения без ручного участия.