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
Отправьте домен с его рынком и прочитайте строку обзора после завершения задачи.
- Отправьте {"target": "notion.so", "location_code": 2840, "language_code": "en"} методом POST на /v1/seo/domain-overview.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Прочитайте единственную строку обзора из 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, который показывает распределение позиций постранично.
Связанные 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 доменов на одном рынке.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API