Temas

API + MCP

GET/v3/content-helper/topics

Este punto de conexión consume una cantidad base de 1000 unidades por solicitud, más 500 unidades si solicitas una URL para puntuar.

El análisis se ejecuta bajo demanda sobre las páginas que actualmente posicionan para la palabra clave, por lo que la primera solicitud para una palabra clave tarda unos segundos. Los resultados se almacenan en caché y las solicitudes repetidas se sirven desde la caché sin coste.

Solo se utilizan SERP que Ahrefs ya ha recopilado, y no se recopila ninguna SERP nueva. Si hemos recopilado una SERP para la palabra clave y el país en los últimos 90 días, el punto de conexión devuelve un error 400 y no se consumen unidades.

Parámetros de consulta

keywordstringObligatorio

La palabra clave para analizar la SERP.

countrystringObligatorio

Un código de país de dos letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazba…

top_competitorsinteger

Cuántas de las páginas mejor posicionadas analizar. Analizar menos páginas acelera el análisis, pero reduce la amplitud.

Opción predeterminada:10

target_urlstring (url)

(500 unidades) Una página tuya para puntuarla según los mismos temas, por ejemplo, un borrador que estés escribiendo o una página que quieras mejorar. La página se obtiene en tiempo real. Consume unidades adicionales de la API cada vez (su puntuación no se almacena en caché).

outputstring

El formato de salida.

Valores permitidos:jsonphp

Respuestas

topicsarray<object>

avg_scorenumber (float)

La puntuación media de cobertura de este tema, de 0 a 100, en las páginas que pudieron analizarse. Un valor alto significa que las páginas que ya posicionan cubren el tema en profundidad. Será nulo cuando no se haya podido analizar ninguna de las páginas.

descriptionstring

De qué trata el tema principal, según se identifica a partir de las páginas competidoras.

pagesarray<object>

Cobertura de este tema por página: un registro con los campos url, position (la posición de la página en la SERP), score (0-100) y extracts (pasajes de la página que cubren el tema). score es nulo y extracts está vacío para una página cuyo contenido no pudo recuperarse, lo cual es distinto de una página que obtuvo una puntuación de cero.

urlstring (url)

positioninteger

scoreinteger

extractsarray<string>

pages_coveringinteger

Cuántas de las páginas analizadas cubren este tema (una puntuación distinta de cero).

serp_datestring (date)

Cuándo se recopiló la SERP analizada.

targetobject or null

Cómo la página indicada como target_url cubre este tema. Será nulo cuando no se haya proporcionado target_url.

urlstring (url)

scoreinteger

extractsarray<string>

topicstring

El nombre del tema principal que cubren las páginas mejor posicionadas.