Themen

API + MCP

GET/v3/content-helper/topics

Dieser Endpunkt verbraucht einen Grundbetrag von 1000 Einheiten pro Anfrage sowie zusätzlich 500 Einheiten, wenn du eine URL zum Bewerten anforderst.

Die Analyse wird bei Bedarf anhand der Seiten ausgeführt, die derzeit für das Keyword ranken. Daher dauert die erste Anfrage für ein Keyword ein paar Sekunden. Ergebnisse werden im Cache gespeichert, und wiederholte Anfragen werden kostenlos aus dem Cache bedient.

Es werden nur SERPs verwendet, die Ahrefs bereits erfasst hat; es wird keine neue SERP erfasst. Wenn wir in den letzten 90 Tagen eine SERP für das Keyword und das Land erfasst haben, gibt der Endpunkt einen 400-Fehler zurück und es werden keine Einheiten verbraucht.

Query-Parameter

keywordstringErforderlich

Das Keyword, für das die SERP analysiert werden soll.

countrystringErforderlich

Ein aus zwei Buchstaben bestehender Ländercode (ISO 3166-1 alpha-2).

Zulässige Werte:adaeafagaialamaoarasatauawazba…

top_competitorsinteger

Wie viele der am höchsten rankenden Seiten analysiert werden sollen. Weniger Seiten machen die Analyse schneller, jedoch auf Kosten der Abdeckung.

Standard:10

target_urlstring (url)

(500 Einheiten) Eine eigene Seite, die anhand derselben Themen bewertet werden soll, z. B. ein Entwurf, den du gerade schreibst, oder eine Seite, die du verbessern möchtest. Die Seite wird live abgerufen. Kostet jedes Mal zusätzliche API-Einheiten (die Bewertung wird nicht gecacht).

outputstring

Das Ausgabeformat.

Zulässige Werte:jsonphp

Antworten

topicsarray<object>

avg_scorenumber (float)

Der durchschnittliche Abdeckungs-Score dieses Themas von 0 bis 100, über die Seiten hinweg, die analysiert werden konnten. Ein hoher Wert bedeutet, dass das Thema durch die Seiten, die bereits ranken, umfassend abgedeckt ist. Null, wenn keine der Seiten analysiert werden konnte.

descriptionstring

Worum es beim Kernthema geht, wie anhand der konkurrierenden Seiten ermittelt.

pagesarray<object>

Abdeckung dieses Themas pro Seite: ein Datensatz mit den Feldern url, position (die SERP-Position der Seite), score (0–100) und extracts (Passagen der Seite, die das Thema abdecken). score und extracts sind null bzw. leer, wenn der Inhalt einer Seite nicht abgerufen werden konnte; das ist nicht dasselbe wie eine Seite, die null Punkte erzielt hat.

urlstring (url)

positioninteger

scoreinteger

extractsarray<string>

pages_coveringinteger

Wie viele der analysierten Seiten dieses Thema überhaupt abdecken (ein Score ungleich null).

serp_datestring (date)

Wann die analysierte SERP erfasst wurde.

targetobject or null

Wie die als target_url angegebene Seite dieses Thema abdeckt. Null, wenn target_url nicht angegeben wurde.

urlstring (url)

scoreinteger

extractsarray<string>

topicstring

Der Name des Kernthemas, das von den am höchsten rankenden Seiten abgedeckt wird.