DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Concorrenti
Siti che condividono domini di riferimento con un target, ordinati per quanti ne condividono. Ogni riga fornisce target, rank e intersections: il numero di domini di riferimento condivisi. main_domain, exclude_large_domains e exclude_internal_backlinks determinano cosa conta. Sono concorrenti nel grafo dei link, non nella ricerca; per questi ultimi usare post_dataforseo_labs_google_serp_competitors_live. Per vedere i domini effettivamente condivisi usare post_dataforseo_backlinks_domain_intersection_live.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.0276.
- Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.
Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array (object | null)[]
- excludeTipo: boolean | null
_internal _backlinks indica se i backlink interni dai sottodomini al
targetverranno esclusi dai risultati
campo facoltativo
se impostato sutrue, i risultati non includeranno dati sui backlink interni dai sottodomini dello stesso dominio deltarget
se impostato sufalse, i link interni verranno inclusi nei risultati
valore predefinito:true - excludeTipo: boolean | null
_large _domains indica se i domini di grandi dimensioni appariranno nei risultati
campo facoltativo
se impostato sutrue, i risultati dei domini di grandi dimensioni (google.com, amazon.com, ecc.) verranno omessi;
valore predefinito:true - filtersTipo: array (object | null)[] | null
array di parametri di filtro dei risultati
campo facoltativo
è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
tra le condizioni impostare un operatore logicoandoor
sono supportati i seguenti operatori:regex,not_regex,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
con l'operatore%inlikeenot_likeè possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
esempio:["rank",">","100"][["target","like","%forbes%"],
"and",
[["rank",">","100"],"or",["intersections",">","5"]]]Oggetto vuoto - limitTipo: integer | null
numero massimo di domini restituiti
campo facoltativo
valore predefinito:100
valore massimo:1000 - mainTipo: boolean | null
_domain indica se nella ricerca verrà incluso solo il dominio principale del
target
campo facoltativo
se impostato sutrue, nella ricerca verrà incluso solo il dominio principale;
valore predefinito:true - 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 verranno saltati e i dati verranno forniti per le pagine successive - 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
il tipo di ordinamento si imposta con una virgola
esempio:["rank,desc"]
nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
per separare più regole di ordinamento usare una virgola
esempio:["intersections,desc","rank,asc"] - rankTipo: string | null
_scale definisce la scala utilizzata per calcolare e visualizzare i valori
rank,domain_from_rankepage_from_rank
campo facoltativocon questo parametro si sceglie se i valori di rank vengono presentati su una scala 0–100 o 0–1000
valori possibili:
one_hundred— i valori di rank vengono visualizzati su una scala 0–100one_thousand— i valori di rank vengono visualizzati su una scala 0–1000valore predefinito:
one_thousandscopri di più sul funzionamento di questo parametro e sul calcolo delle metriche di ranking in questo articolo del Help Center
- 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 - targetTipo: string
dominio, sottodominio o pagina web per cui ottenere i domini concorrenti
campo obbligatorio
un dominio o un sottodominio va specificato senzahttps://ewww.
una pagina va specificata con URL assoluto (inclusihttp://ohttps://)
- Tipo: object | null · Response36Afe1097B20_BacklinksCompetitorsLiveResponseInfo200
- 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_BacklinksCompetitorsLiveTaskInfo
- 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
array di elementi
- intersectionsTipo: integer | null
indica il numero di intersezioni di backlink con il
targetspecificato nell'array POST - rankTipo: integer | null
- targetTipo: string | null
dominio concorrente
- typeTipo: string | null
tipo di elemento
- itemsTipo: integer | null Formato: int64
_count numero di elementi nell'array
items - totalTipo: integer | null Formato: int64
_count numero totale di elementi pertinenti nel database
- 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/backlinks/competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"filters": [
"rank",
">",
100
],
"order_by": [
"rank,desc"
],
"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": [
{
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"target": null,
"rank": null,
"intersections": null
}
]
}
]
}
]
}