Keywords for Site
Записи Keywords for Site связывают тематику сайта с релевантными поисковыми запросами, объемом поиска, CPC, конкуренцией в платном поиске, помесячным спросом и категориями. Эти связи между ключевыми словами и метриками помогают находить темы, исследовать конкурентов, составлять списки кандидатов и сравнивать домены между собой.
Возможности Keywords for Site API
- Поиск релевантных запросов по доменуИспользуйте один домен сайта, чтобы получить идеи ключевых слов, связанные с его тематикой, а не начинать с исходной фразы.
- Метрики спроса и платного поискаОценивайте каждое возвращенное ключевое слово по нормализованным объему поиска, CPC, конкуренции в платном поиске, уровню конкуренции и помесячным наблюдениям.
- Полный контекст ключевого словаИзучайте в extra всю возвращенную строку, где остаются доступны необязательные категории, сложность, намерение, тренды и другие атрибуты, не вынесенные на верхний уровень.
Параметры Keywords for Site API
| Параметры | Обязательный | Описание |
|---|---|---|
target | Обязательный | Обязательный домен сайта, который служит источником тематики. В песочнице по умолчанию используется microsoft.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. Песочница отправляет 5, как в примере из документации; если значение не указано, бэкенд использует 100. |
Как использовать Keywords for Site API
Отправьте один домен с настройками рынка, языка и лимита результатов, а затем читайте нормализованные записи ключевых слов из завершенной задачи.
- Выберите один домен в target, положительный location_code, language_code и results_limit от 1 до 1 000.
- Отправьте данные методом POST на /v1/seo/keywords-for-site и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и следуйте next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
-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Сценарии использования Keywords for Site API
- Поиск тем сайта: Используйте возвращенные ключевые слова и категории, чтобы определить поисковые темы, связанные с известным сайтом.
- Исследование ключевых слов конкурентов: Передайте домен конкурента и сочетайте релевантные запросы с объемом поиска, CPC и конкуренцией в платном поиске, чтобы собрать исследовательский набор.
- Сравнение тематики разных доменов: Запускайте задачи по сайтам по отдельности и сравнивайте возвращенные наборы ключевых слов, категории и метрики спроса.
Практические советы по Keywords for Site API
- Удаляйте http:// и https:// из target перед отправкой домена, чтобы избежать недопустимого формата target.
- При сравнении запусков задавайте рынок и язык явно, а не полагайтесь на поведение поставщика для незаполненных полей.
- Выбирайте results_limit как наибольший полезный набор результатов за один раз: у этого эндпоинта нет offset для запроса более позднего окна результатов.
- Считайте отсутствующие метрики недоступными, а не нулевыми, и проверяйте extra, если нужного атрибута нет среди нормализованных полей.
- Если задача требует фактических позиций или URL в выдаче, а не идей ключевых слов по релевантности, используйте Ranked Keywords.
Связанные API
Помимо Keywords for Site API, используйте эти API, когда нужен другой тип публичных данных SEO.
- Google Organic SERP API — Получайте одну актуальную страницу выдачи Google по запросу и рынку: нормализованные целевые URL, позиции, типы элементов и полные данные результатов.
- Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
- Keyword Overview API — Дополняйте пакет ключевых слов доступными данными о спросе, конкуренции в платной выдаче, сложности, ежемесячной частотности и интенте.
- Keyword Search Volume API — Измеряйте известные ключевые слова: доступная частотность, CPC, конкуренция в платной выдаче и история частотности по месяцам.
- Ranked Keywords API — Находите ключевые слова, по которым ранжируется домен, поддомен или страница: соответствующие URL, позиции, поисковые метрики, интент и полные исходные элементы.
- Relevant Pages API — Составляйте перечень проиндексированных страниц одного домена с распределением позиций в органической и платной выдаче, расчетным трафиком и оценкой стоимости.
- 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