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
Отправьте один правильно оформленный домен с настройками рынка и ограниченным окном источника, а затем читайте каждую релевантную страницу из завершенной асинхронной задачи.
- Выберите один домен без https:// и www., location_code, language_code, results_limit от 1 до 1 000 и offset не меньше 0.
- Отправьте данные методом POST на /v1/seo/relevant-pages и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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 как расчетные поисковые оценки, а не закрытую аналитику или фактическую выручку.
Связанные API
Помимо 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, позиции, поисковые метрики, интент и полные исходные элементы.
- Keyword Suggestions API
- Related Keywords API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API