Теми

API + MCP

GET/v3/content-helper/topics

Ця кінцева точка споживає базовий обсяг 1000 юнітів за запит, а також 500 юнітів, якщо ви запитуєте URL-адресу для оцінювання.

Аналіз запускається на вимогу для сторінок, які наразі ранжуються за ключовим словом, тому перший запит для ключового слова займає кілька секунд. Результати кешуються, а повторні запити обслуговуються з кешу безкоштовно.

Використовуються лише SERP, які Ahrefs уже зібрав, і нові SERP не збираються. Якщо ми зібрали SERP для цього ключового слова та країни за останні 90 днів, кінцева точка повертає помилку 400, і жодні юніти не списуються.

Параметри запиту

keywordstringОбов’язково

Ключове слово, для якого потрібно проаналізувати SERP.

countrystringОбов’язково

Двобуквений код країни (ISO 3166-1 alpha-2).

Дозволені значення:adaeafagaialamaoarasatauawazba…

top_competitorsinteger

Скільки сторінок із найвищими позиціями проаналізувати. Менша кількість сторінок пришвидшує аналіз, але зменшує його охоплення.

За Замовчуванням:10

target_urlstring (url)

(500 юнітів) Ваша власна сторінка для оцінювання за тими самими темами — наприклад, чернетка, над якою ви працюєте, або сторінка, яку хочете покращити. Сторінка завантажується в реальному часі. Кожного разу списуються додаткові юніти API (оцінювання не кешується).

outputstring

Формат виводу.

Дозволені значення:jsonphp

Відповіді

topicsarray<object>

avg_scorenumber (float)

Середній показник охоплення цієї теми (від 0 до 100) за сторінками, які вдалося проаналізувати. Високе значення означає, що сторінки, які вже ранжуються, ґрунтовно висвітлюють тему. Null, якщо не вдалося проаналізувати жодну зі сторінок.

descriptionstring

Про що йдеться в основній темі, визначеній на основі сторінок-конкурентів.

pagesarray<object>

Охоплення цієї теми за кожною сторінкою: запис із полями url, position (позиція сторінки в SERP), score (0–100) і extracts (уривки зі сторінки, що висвітлюють тему). Поле score має значення null, а поле extracts порожнє для сторінки, контент якої не вдалося отримати, — це відрізняється від сторінки з нульовою оцінкою.

urlstring (url)

positioninteger

scoreinteger

extractsarray<string>

pages_coveringinteger

Скільки з проаналізованих сторінок взагалі охоплюють цю тему (ненульова оцінка).

serp_datestring (date)

Коли було зібрано проаналізований SERP.

targetobject or null

Як сторінка, вказана як target_url, охоплює цю тему. Null, якщо target_url не було вказано.

urlstring (url)

scoreinteger

extractsarray<string>

topicstring

Назва основної теми, яку висвітлюють сторінки з найвищими позиціями.