DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Concorrenti SERP
I domini che si posizionano accanto a te su un insieme di keywords, con quante ne condividono. Restituisce se_type, seed_keywords, total_count, items_count e items. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. ⚠️ Questi sono concorrenti di ricerca, decisi dai posizionamenti condivisi. L'equivalente sul grafo dei link è post_dataforseo_backlinks_competitors_live, e le due liste spesso non concordano – il che è di per sé informativo.
Riferimento prezzi
- Misurazione: costo della risposta comunicato.
- Stima di riferimento per richiesta: USD 0.0192.
- Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array (object | null)[]
- filtersTipo: array (object | null)[] | null
array di parametri per il filtraggio dei risultati
campo facoltativo
è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
tra le condizioni è necessario impostare un operatore logicoand,or
sono supportati i seguenti operatori:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like
con l'operatore%è possibile usarelikeenot_like, nonchéilikeenot_ilikeper trovare qualsiasi stringa di zero o più caratteri
esempio:["median_position","in",[1,10]][["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]][["domain","not_like","%wikipedia.org%"],
"and",
[["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
per ulteriori informazioni sui filtri, fare riferimento a Dataforseo Labs - Filters o a questa guida del Help CenterOggetto vuoto - includeTipo: boolean | null
_subdomains indica se i sottodomini verranno inclusi nella ricerca
campo facoltativo
se impostato sufalse, i sottodomini verranno ignorati
valore predefinito:true - itemTipo: array string[] | null
_types tipo di risultati di ricerca
indica il tipo di risultati di ricerca inclusi nella risposta
campo facoltativovalori possibili:
["organic", "paid", "featured_snippet", "local_pack"]
valore predefinito:["organic", "paid"] - keywordsTipo: array string[]
array di keyword
campo obbligatorio
i risultati si basano sulle keyword specificate in questo array
codifica UTF-8;
le keyword vengono convertite in minuscolo;
è possibile specificare un massimo di 200 keywordscopri di più su regole e limiti dei campi
keywordekeywordsnelle API DataForSEO in questo articolo del Help Center - languageTipo: string | null
_code identificatore univoco della lingua
campo obbligatorio se non specifichilanguage_name
Nota: è necessario specificarelanguage_nameoppurelanguage_code
è possibile ottenere l'elenco delle lingue disponibili con i relativi parametrilanguage_codeeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:en - languageTipo: string
_name nome completo della lingua
campo obbligatorio se non specifichilanguage_code
Nota: è necessario specificarelanguage_nameoppurelanguage_code
è possibile ottenere l'elenco delle lingue disponibili con i relativi parametrilanguage_nameeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:English - limitTipo: integer | null
numero massimo di domini restituiti
campo facoltativo
valore predefinito:100
valore massimo:1000 - locationTipo: integer
_code identificatore univoco della località
campo obbligatorio se non specifichilocation_name
Nota: è necessario specificarelocation_nameoppurelocation_code
è possibile ottenere l'elenco delle località disponibili con i relativi parametrilocation_codeeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:2840 - locationTipo: string
_name nome completo della località
campo obbligatorio se non specifichilocation_code
Nota: è necessario specificarelocation_nameoppurelocation_code
è possibile ottenere l'elenco delle località disponibili con i parametrilocation_nameeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:United Kingdom - offsetTipo: integer | null
offset nell'array dei risultati dei domini restituiti
campo facoltativo
valore predefinito:0
se si specifica il valore10, i primi dieci domini nell'array dei risultati vengono omessi e i dati vengono forniti per i domini successivi - orderTipo: array string[] | null
_by regole di ordinamento dei risultati
campo facoltativo
è possibile usare gli stessi valori dell'arrayfiltersper ordinare i risultati
tipi di ordinamento possibili:asc– i risultati vengono ordinati in ordine crescentedesc– i risultati vengono ordinati in ordine decrescente
la virgola viene usata come separatore
esempio:["avg_position,asc"]
regola predefinita:["rating,desc"]
Nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
per separare più regole di ordinamento usare una virgola
esempio:["avg_position,asc","etv,desc"] - tagTipo: string | null
identificatore dell'attività definito dall'utente
campo facoltativo
il limite di caratteri è 255
puoi usare questo parametro per identificare l'attività e associarla al risultato
il valoretagspecificato si trova nell'oggettodatadella risposta
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo200
- Tipo: number | null Formato: doublecost
Costo totale delle attività, USD
- Tipo: integer | nullstatus
_code codice di stato generale l'elenco completo dei codici di risposta è disponibile qui
- Tipo: string | nullstatus
_message messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui
- Tipo: array (object | null)[] | nulltasks
array di attività
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
- costTipo: number | null Formato: double
Costo totale delle attività, USD
- dataTipo: object | null
Contiene gli stessi parametri specificati nella richiesta POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID
- pathTipo: array (string | null)[] | null
Percorso URL
- resultTipo: array (object | null)[] | null
array di risultati
- itemsTipo: array (object | null)[] | null
contiene i concorrenti SERP rilevati e i dati correlati
- avgTipo: number | null Formato: float
_position la posizione media del dominio per le keyword specificate
la media aritmetica dei valori nell'arraykeywords_positions - domainTipo: string | null
nome di dominio del concorrente SERP rilevato
- etvTipo: number | null
volume di traffico stimato
rappresenta il traffico mensile stimato che le keyword specificate portano al sito web
calcolato come la somma dei prodotti tra i valori di volume di ricerca delle keyword specificate e i tassi CTR (click-through rate) in determinate posizioni in SERP
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center - keywordsTipo: integer | null Formato: int64
_count il numero di keyword specificate per cui il dominio ha posizioni nei SERP
- keywordsTipo: object | null
_positions posizioni delle keyword
posizioni SERP che il dominio correlato occupa in SERP per le keyword specificate- propertyTipo: array (integer | null)[] | null
Name
- medianTipo: number | null
_position la posizione mediana del dominio per le keyword specificate
la mediana dei valori nell'arraykeywords_positions - ratingTipo: number | null
la differenza tra le posizioni massime possibili e quelle effettive delle keyword
rappresenta il tasso di visibilità relativa del dominio in SERP per le keyword specificate
calcolato come somma(100-keywords_positions) - relevantTipo: integer | null
_serp _items il numero di elementi SERP pertinenti al dominio
rappresenta il numero di risultati di ricerca in SERP pertinenti al dominio per le keyword specificate - seTipo: string | null
_type tipo di motore di ricerca
- visibilityTipo: number | null
tasso di visibilità SERP
rappresenta il tasso di visibilità del sito web in base alle posizioni SERP delle keyword specificate
Alle keyword con posizioni nell'intervallo da 1 a 10 viene assegnato l'indice di visibilità da 1 a 0,1
Le keyword con posizioni nell'intervallo da 11 a 20 hanno l'indice di visibilità fisso di 0,05
le keyword con posizioni da 20 a 100 hanno un indice di visibilità pari a 0
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - languageTipo: string | null
_code codice lingua in un array POST
se non ci sono dati, il valore ènull - locationTipo: integer | null
_code codice località in un array POST
se non ci sono dati, il valore ènull - seTipo: string | null
_type tipo di motore di ricerca
- seedTipo: array (string | null)[] | null
_keywords keyword specificate nella richiesta
la keyword viene restituita con %## decodificato (il carattere più '+' viene decodificato in uno spazio) - totalTipo: integer | null Formato: int64
_count il numero totale di risultati nel nostro database pertinenti alla richiesta
- resultTipo: integer | null Formato: int64
_count Numero di elementi nell'array dei risultati
- statusTipo: integer | null
_code codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui
- statusTipo: string | null
_message messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui
- timeTipo: string | null
Tempo di esecuzione in secondi
- Tipo: integer | null Formato: int64tasks
_count Il numero di attività nell'array tasks
- Tipo: integer | null Formato: int64tasks
_error Il numero di attività nell'array tasks restituite con un errore
- Tipo: string | nulltime
tempo di esecuzione totale, secondi
- Tipo: string | nullversion
La versione corrente dell'API
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"phone"
],
"language_name": "English",
"location_code": 2840,
"item_types": [
"organic"
],
"limit": 5
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"seed_keywords": [
null
],
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"domain": null,
"avg_position": null,
"median_position": null,
"rating": null,
"etv": null,
"keywords_count": null,
"visibility": null,
"relevant_serp_items": null,
"keywords_positions": null
}
]
}
]
}
]
}