Metriche dei concorrenti

API + MCP

GET/v3/rank-tracker/competitors-stats

Le richieste a questo endpoint sono gratuite e non consumano alcuna unità API.

Parametri della query

selectstringObbligatorio

Un elenco di colonne separate da virgole da restituire. Consulta lo schema di risposta per gli identificatori di colonna validi.

datestringObbligatorio

Una data per il Report delle metriche nel formato YYYY-MM-DD.

devicestringObbligatorio

Scegli tra classifiche mobile e desktop.

Valori consentiti:desktopmobile

project_idintegerObbligatorio

L'identificatore univoco del progetto. Puoi trovarlo nell'URL del tuo progetto Rank Tracker in Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

La modalità di calcolo del Volume di ricerca: mensile o media. Influisce su volume, traffico e Valore del traffico.

Valori consentiti:monthlyaverage

Predefinita:monthly

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

competitors-metricsarray<object>

ai_overview_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in un'AI Overview.

average_positionnumber or null

La media delle posizioni più alte del tuo target per tutte le parole chiave monitorate.

competitorstring

URL del concorrente.

discussions_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in Discussions e forum.

featured_snippet_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in uno Snippet in primo piano.

image_pack_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in un Image pack.

knowledge_card_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in una Knowledge card.

knowledge_panel_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in un Knowledge panel.

pos_11_20integer

Il numero totale di parole chiave monitorate per le quali la migliore posizione organica del tuo target è compresa tra l'11° e il 20° risultato.

pos_1_3integer

Il numero totale di keyword monitorate per le quali la migliore posizione organica del tuo target rientra nei primi 3 risultati.

pos_21_50integer

Il numero totale di keyword monitorate per le quali la migliore posizione organica del tuo target è compresa tra il 21° e il 50° risultato.

pos_4_10integer

Il numero totale di keyword monitorate per le quali la migliore posizione organica del tuo target è compresa tra il 4° e il 10° risultato.

pos_51_plusinteger

Il numero totale di parole chiave monitorate per le quali la migliore posizione organica del tuo target è pari o superiore al 51° risultato.

pos_no_rankinteger

Il numero totale di parole chiave monitorate per le quali il tuo target non si posiziona.

share_of_traffic_valuenumber

La quota del valore del traffico di ricerca organico del tuo target rispetto al valore totale del traffico di ricerca organico per tutte le parole chiave monitorate.

share_of_voicenumber

La quota di traffico di ricerca organico del tuo target rispetto al traffico di ricerca organico totale per tutte le parole chiave monitorate.

sitelinks_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona nei Sitelink.

thumbnail_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in una miniatura.

top_stories_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in Top stories.

trafficinteger or null

Il numero stimato di visite mensili che il tuo target riceve dalla ricerca organica per tutte le parole chiave monitorate.

traffic_valueinteger or null

Valore del traffico mensile stimato del tuo target per tutte le parole chiave monitorate.

video_preview_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in un'anteprima video.

videos_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in Videos.

x_countinteger

Il numero totale di parole chiave monitorate per le quali il tuo target si posiziona in un widget di X (Twitter).