seo/
domain-overview

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

Domain Overview API

Органика и реклама
Диапазоны позиций 1–100
Рынок: страна и язык
5 кредитов за запрос
Готово
Готово

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

README

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

Domain Overview

Поисковое присутствие домена — это его видимость в результатах Google для одной страны и языка, выраженная числом ключевых слов, по которым он ранжируется, оценкой месячных визитов от этих позиций и стоимостью такого трафика в рекламе, с разделением на органику и платный поиск, распределением по диапазонам позиций от 1 до 100 и числом новых, растущих, падающих и потерянных позиций. Одна строка таких итогов позволяет оценить масштаб конкурента, квалифицировать потенциального клиента по присутствию в поиске и, если сохранять ее месяц за месяцем, отслеживать изменение видимости собственного сайта.

Возможности Domain Overview API

  • Один домен на одном рынке Googletarget принимает домен, а параметры местоположения и языка выбирают страну и язык результатов поиска, по умолчанию США и английский; строка повторяет location_code и language_code, чтобы сохраненные снимки оставались подписанными.
  • Органика и реклама в одной формеorganic и paid содержат одинаковый набор итогов, так что бесплатные позиции и поисковую рекламу можно сравнивать поле за полем.
  • Трафик и его рекламная стоимостьkeywords_count считает ранжируемые ключевые слова, estimated_traffic дает приносимые ими визиты в месяц, а estimated_traffic_cost оценивает этот трафик в долларах США по ставкам Google Ads.
  • Двенадцать диапазонов позицийpositions делит ранжируемые ключевые слова на pos_1, pos_2_3, pos_4_10 и следующие диапазоны вплоть до pos_91_100, показывая, занимает ли домен первую страницу или находится глубже в выдаче.
  • Движение позиций с последнего обновленияnew_count, up_count, down_count и lost_count показывают, сколько ключевых слов вошли в ранжирование, поднялись, опустились или выпали из него с предыдущего обновления данных.

Параметры Domain Overview API

ПараметрыОбязательныйОписание
targetОбязательныйДомен или поддомен для анализа, например notion.so; https:// и www. удаляются, а URL с путем отклоняется.
location_codeНеобязательныйЧисловой код страны поиска, например 2840 для США, который используется по умолчанию. Укажите его или location_name.
location_nameНеобязательныйНазвание страны, например United States, как альтернатива location_code; если переданы оба, они должны обозначать одну страну.
language_codeНеобязательныйКод языка, например en (по умолчанию); он должен входить в языки, доступные для выбранной страны.
languageНеобязательныйНазвание языка, например English, как альтернатива language_code; если переданы оба, они должны совпадать.

Как использовать Domain Overview API

Отправьте домен с его рынком и прочитайте строку обзора после завершения задачи.

  1. Отправьте {"target": "notion.so", "location_code": 2840, "language_code": "en"} методом POST на /v1/seo/domain-overview.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте единственную строку обзора из results.items; results.next_cursor важен, только если has_more равно true.
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","location_code":2840,"language_code":"en"}'

# One market per request, 5 credits.

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

  • Оценка присутствия конкурента в поиске: Читайте organic.keywords_count и organic.estimated_traffic, чтобы понять, какую часть рынка конкурент уже охватывает через Google.
  • Помесячное отслеживание своей видимости: Каждый месяц сохраняйте диапазоны positions и счетчики new, up, down и lost, чтобы видеть на графике, поднимаются ли позиции к первой странице.
  • Квалификация потенциальных клиентов агентства: Используйте organic.estimated_traffic_cost как денежную оценку поискового трафика потенциального клиента, когда решаете, какими аккаунтами заниматься.
  • Проверка, покупает ли сайт поисковую рекламу: paid.keywords_count и paid.estimated_traffic показывают, размещает ли домен поисковую рекламу Google на рынке и сколько трафика она приносит.
  • Сравнение одного сайта по странам: Отправьте один и тот же домен с разными настройками местоположения и языка, чтобы увидеть, на каких рынках он сильнее всего.

Практические советы по Domain Overview API

  • Для страны, где английский не предлагается, задайте language_code или language сами: значение en по умолчанию принимается, только если в этой стране доступен английский.
  • Складывайте pos_1, pos_2_3 и pos_4_10, чтобы получить число ключевых слов на первой странице: диапазоны не пересекаются.
  • Читайте счетчики new, up, down и lost как изменения с предыдущего обновления данных, а не с вашего последнего запроса, и сохраняйте каждую строку с collected_at, чтобы вести собственную историю.
  • Отправляйте голый домен; для показателей отдельных страниц сайта используйте Relevant Pages API, который показывает распределение позиций постранично.

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

  • Google Organic SERP API — Получайте одну актуальную страницу выдачи Google по запросу и рынку: нормализованные целевые URL, позиции, типы элементов и полные данные результатов.
  • Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
  • Keyword Overview API — Дополняйте пакет ключевых слов доступными данными о спросе, конкуренции в платной выдаче, сложности, ежемесячной частотности и интенте.
  • Ranked Keywords API — Находите ключевые слова, по которым ранжируется домен, поддомен или страница: соответствующие URL, позиции, поисковые метрики, интент и полные исходные элементы.
  • Competitor Domains API — Находите домены, которые ранжируются по тем же ключевым словам Google, что и сайт, на одном рынке: общие ключевые слова, средняя позиция, трафик пересечения и полные итоги поиска.
  • Traffic Estimate API — Оценивайте месячные органические и платные визиты из поиска Google и число ключевых слов для списка до 1 000 доменов на одном рынке.

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

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

Domain Overview API — FAQ

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

Он проверяет поисковый трафик: estimated_traffic — это оценка числа визитов в месяц, которые домен получает из результатов Google на выбранном рынке, отдельно для органики и рекламы.

Задайте страну через location_code или location_name, а язык — через language_code или language; язык должен быть доступен в этой стране. Без них запрос использует США и английский.

Это оценочная месячная стоимость покупки такого же трафика через Google Ads в долларах США, которая переводит органическую видимость в сопоставимую денежную величину.

Каждый запрос охватывает один домен. Чтобы сравнить трафик и число ключевых слов для длинного списка, используйте Traffic Estimate API, который принимает до 1 000 доменов сразу.

Фиксированные 5 кредитов за запрос, который охватывает один домен на одном рынке.