seo/
relevant-pages

Составляйте перечень проиндексированных страниц одного домена и получайте URL страниц, распределение позиций, расчетный поисковый трафик и стоимость платного поиска в нормализованных записях.

Relevant Pages API

Видимость страниц
Распределение позиций
Оценки трафика
0,15 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Relevant Pages

Релевантные страницы — это проиндексированные URL с измеримой видимостью в органическом или платном поиске, включая число ключевых слов, группы позиций, расчетный трафик, оценки стоимости и показатели динамики. Такие замеры на уровне страниц помогают составлять перечень видимых страниц, сравнивать поисковое присутствие, оценивать ценность трафика и анализировать повторные снимки.

Возможности Relevant Pages API

  • Перечень страниц доменаВозвращает абсолютные URL страниц одного домена, у которых есть измеримая органическая или платная релевантность в выбранном поисковом индексе.
  • Распределение органических позицийСохраняет число органических ключевых слов по группам позиций вместе с числом новых, растущих, падающих и потерянных позиций, если они доступны.
  • Присутствие в платном поискеПоказывает доступное число платных ключевых слов, диапазоны позиций, расчетный трафик и оценку стоимости платного трафика для каждой страницы.
  • Полные объекты метрик страницыХранит вложенные органические, платные и другие изменчивые замеры на уровне страницы в extra, нормализуя URL страницы для стабильной идентификации.

Параметры Relevant Pages API

ПараметрыОбязательныйОписание
targetОбязательныйОбязательный домен без https:// и www., например example.com.
location_codeНеобязательныйПоложительный числовой код поискового рынка. В песочнице по умолчанию используется 2840.
location_nameНеобязательныйНеобязательное название поискового рынка вместо location_code. Если оно заполнено, оно имеет приоритет над location_code.
language_codeНеобязательныйКод языка поиска длиной от 2 до 10 символов. В песочнице по умолчанию используется en.
languageНеобязательныйНеобязательное название языка поиска вместо language_code. Если оно заполнено, оно имеет приоритет над language_code.
results_limitНеобязательныйЗапрошенный максимум от 1 до 1 000 записей проиндексированных страниц. Строк может вернуться меньше.
offsetНеобязательныйЧисло строк источника (отсчет от нуля), которые нужно пропустить перед сбором запрошенного окна результатов.

Как использовать Relevant Pages API

Отправьте один правильно оформленный домен с настройками рынка и ограниченным окном источника, а затем читайте каждую релевантную страницу из завершенной асинхронной задачи.

  1. Выберите один домен без https:// и www., location_code, language_code, results_limit от 1 до 1 000 и offset не меньше 0.
  2. Отправьте данные методом POST на /v1/seo/relevant-pages и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items, а затем запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/seo/relevant-pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Перечень страниц, видимых в поиске: Используйте возвращенные URL страниц, чтобы составить перечень страниц домена, ограниченный страницами с измеримой релевантностью в поисковом индексе.
  • Сравнение органического присутствия: Сравнивайте число органических ключевых слов, группы позиций и поля динамики, чтобы понять, как видимость распределена между страницами.
  • Анализ страниц в платном поиске: Используйте число платных ключевых слов, диапазоны позиций, расчетный трафик и оценку стоимости, чтобы сравнивать присутствие возвращенных страниц в платном поиске.
  • Снимки видимости страниц: Сохраняйте повторные записи по page_address и рынку, чтобы сравнивать распределение позиций и расчетный трафик в разные моменты сбора.

Практические советы по Relevant Pages API

  • Убирайте https:// и www. из target перед отправкой: этот эндпоинт ожидает домен, а не полный URL страницы.
  • Используйте возвращенный url как идентификатор страницы; text — это тот же URL в качестве резервного значения, и он не содержит текста страницы.
  • Не меняйте target, location_code, language_code, results_limit и offset при сравнении повторных окон результатов.
  • Считайте offset числом строк источника, а не номером страницы, и храните его отдельно от next_cursor результатов задачи.
  • Читайте органические и платные замеры из extra.metrics и допускайте отсутствие вложенных групп метрик или отдельных полей.
  • Рассматривайте etv и estimated_paid_traffic_cost как расчетные поисковые оценки, а не закрытую аналитику или фактическую выручку.

Помимо Relevant Pages API, используйте эти API, когда нужен другой тип публичных данных SEO.

  • Google Organic SERP API — Получайте одну актуальную страницу выдачи Google по запросу и рынку: нормализованные целевые URL, позиции, типы элементов и полные данные результатов.
  • Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
  • Keyword Overview API — Дополняйте пакет ключевых слов доступными данными о спросе, конкуренции в платной выдаче, сложности, ежемесячной частотности и интенте.
  • Keyword Search Volume API — Измеряйте известные ключевые слова: доступная частотность, CPC, конкуренция в платной выдаче и история частотности по месяцам.
  • Keywords for Site API — Подбирайте ключевые слова, релевантные одному сайту, с доступными данными о спросе, помесячной историей, контекстом рынка и полными исходными строками.
  • Ranked Keywords API — Находите ключевые слова, по которым ранжируется домен, поддомен или страница: соответствующие URL, позиции, поисковые метрики, интент и полные исходные элементы.

Другие платформы

Объединяйте данные SEO с публичными данными других поддерживаемых соцсетей.

Relevant Pages API — FAQ

Relevant Pages API — это программный интерфейс для поиска проиндексированных страниц с измеримой поисковой релевантностью для одного домена, указанного без протокола и www. Он возвращает URL страниц, распределение органических и платных позиций, расчетный трафик, оценки стоимости, число изменений позиций и полные строки источника.

Передайте один домен, например example.com, без https:// и без www. Не передавайте полный URL страницы для этого перечня страниц домена.

Нет. Он возвращает страницы, известные поисковому индексу и имеющие измеримую органическую или платную релевантность, поэтому непроиндексированные страницы и страницы без измеримой видимости могут не попасть в результат.

Строка источника может включать число органических и платных ключевых слов, группы позиций, расчетный трафик, оценку стоимости платного трафика и число изменений позиций. Эти вложенные значения остаются в extra.metrics, а не в нормализованном объекте metrics верхнего уровня.

Нет. etv и значения стоимости трафика — это расчетные поисковые оценки, а не закрытая аналитика, фактические посещения или данные о выручке.

Каждая возвращенная страница стоит 0,15 кредита SocQ. За пустой набор результатов плата не взимается, а results_limit задает предварительную оценку, а не гарантированное итоговое число.