DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Riepilogo backlink
L'intero profilo backlink di un target in una sola chiamata: first_seen, lost_date, rank, backlinks, backlinks_spam_score, crawled_pages, internal_links_count e un blocco info, con i conteggi di domini di riferimento e ancore accanto. È il fulcro della famiglia: partire da qui, poi approfondire la parte che conta: post_dataforseo_backlinks_backlinks_live per i singoli link, post_dataforseo_backlinks_referring_domains_live per chi collega, post_dataforseo_backlinks_anchors_live per il testo usato. Questo endpoint non ha un parametro limit, quindi l'unica leva è chiamarlo meno spesso.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.024.
- 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)[]
- backlinksTipo: array (object | null)[] | null
_filters filtra i backlink del
target
campo facoltativo
è possibile usare questo campo per filtrare i backlink iniziali che verranno inclusi nel dataset per le metriche aggregate deltarget
è possibile filtrare i backlink per tutti i campi disponibili nella risposta di questo endpoint
con questo parametro è possibile includere nella risposta solo i backlink dofollow e creare un dataset di backlink flessibile su cui calcolare le metriche
esempio:"backlinks_filters": ["dofollow", "=", true]Oggetto vuoto - backlinksTipo: string | null
_status _type impostare quali backlink restituire e conteggiare
campo facoltativo
è possibile usare questo campo per scegliere quali backlink verranno restituiti e usati per le metriche aggregate deltarget;
valori possibili:all- tutti i backlink verranno restituiti e conteggiati;live- i backlink trovati durante l'ultimo controllo verranno restituiti e conteggiati;lost- i backlink persi verranno restituiti e conteggiati;valore predefinito:
live - 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 - includeTipo: boolean | null
_indirect _links indica se i link indiretti al
targetverranno inclusi nei risultati
campo facoltativo
se impostato sutrue, i risultati includeranno dati sui link indiretti che puntano a una pagina che reindirizza al target o che punta a una pagina canonica
se impostato sufalse, i link indiretti verranno ignorati
valore predefinito:true - includeTipo: boolean | null
_subdomains indica se i sottodomini del
targetverranno inclusi nella ricerca
campo facoltativo
se impostato sufalse, i sottodomini verranno ignorati
valore predefinito:true - internalTipo: integer | null
_list _limit numero massimo di elementi negli array interni
campo facoltativo
è possibile usare questo campo per limitare il numero di elementi nei seguenti array:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsvalore predefinito:
10
valore massimo:1000 - 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 dati
campo obbligatorio
un dominio o un sottodominio va specificato senzahttps://ewww.
una pagina va specificata con URL assoluto (inclusihttp://ohttps://)
- Tipo: object | null · Response36Afe1097B20_BacklinksSummaryLiveResponseInfo200
- 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_BacklinksSummaryLiveTaskInfo
- 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
- backlinksTipo: integer | null Formato: int64
indica il numero di backlink
- backlinksTipo: integer | null Formato: int64
_spam _score - brokenTipo: integer | null Formato: int64
_backlinks numero di backlink interrotti
numero di backlink interrotti che puntano altarget - brokenTipo: integer | null
_pages numero di pagine interrotte
numero di pagine deltargetche rispondono con codici di stato 4xx o 5xxnota che il numero di pagine interrotte include le pagine del
targetscoperte seguendo i link esterni, ma può includere anche le pagine scoperte seguendo la sitemap del target - crawledTipo: integer | null
_pages numero di pagine scansionate per il
target - externalTipo: integer | null Formato: int64
_links _count numero di link esterni sulla pagina
calcolato come somma dei link esterni sulle pagine deltargetspecificato - firstTipo: string | null
_seen data e ora in cui il nostro crawler ha trovato il backlink per il
targetper la prima volta
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - infoTipo: object | null · Response36Afe1097B20_TargetInfo
informazioni sul
target- cmsTipo: string | null
sistema di gestione dei contenuti
- countryTipo: string | null
codice paese a cui si ritiene appartenga il dominio
target - ipTipo: string | null
_address indirizzo IP del
target - isTipo: boolean | null
_ip indica se il
targetè un IP
setrue, il dominio, sottodominio o la pagina web funziona come indirizzo IP e non ha un nome di dominio - platformTipo: array (string | null)[] | null
_type tipo di piattaforma
- serverTipo: string | null
server
- targetTipo: integer | null
_spam _score
- internalTipo: integer | null Formato: int64
_links _count numero di link interni
calcolato come somma dei link interni sulle pagine deltargetspecificato - lostTipo: string | null
_date data e ora in cui è stato perso il backlink
indica la data e l'ora in cui il nostro crawler ha visitato il target e questo ha risposto con un codice di stato 4xx o 5xx, oppure in cui è stato rimosso il suo ultimo backlink
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - rankTipo: integer | null
- referringTipo: integer | null Formato: int64
_domains indica il numero di domini di riferimento
i domini di riferimento includono i sottodomini, che per questa metrica vengono conteggiati come domini separati - referringTipo: integer | null Formato: int64
_domains _nofollow numero di domini che puntano almeno un link nofollow al
target - referringTipo: integer | null Formato: int64
_ips numero di indirizzi IP di riferimento
numero di indirizzi IP che puntano a questa pagina - referringTipo: object | null
_links _attributes attributi del link dei link di riferimento
indica gli attributi del link dei link di riferimento e il numero di link per ciascun attributo
valori di esempio:nofollow,noopener,noreferrer,external,ugc,sponsored- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _countries codici paese ISO dei link di riferimento
indica i codici paese ISO dei domini in cui si trovano i link di riferimento e il numero di link per ciascun paese- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _platform _types tipi di piattaforme di riferimento
indica i tipi di piattaforme di riferimento e il numero di link per ciascuna piattaformavalori possibili:
cms,blogs,ecommerce,message-boards,wikis,news,organization- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _semantic _locations - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _tld domini di primo livello dei link di riferimento
contiene i domini di primo livello e il numero di link di riferimento per ciascuno- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: object | null
_links _types tipi di link di riferimento
indica i tipi di link di riferimento e il numero di link per ciascun tipo
valori possibili:anchor,image,link,meta,canonical,alternate,redirect- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- referringTipo: integer | null Formato: int64
_main _domains indica il numero di domini principali di riferimento
- referringTipo: integer | null Formato: int64
_main _domains _nofollow numero di domini principali che puntano almeno un link nofollow al
target - referringTipo: integer | null Formato: int64
_pages indica il numero di pagine che puntano al target
- referringTipo: integer | null Formato: int64
_pages _nofollow numero di pagine di riferimento che puntano almeno un link nofollow al
target - referringTipo: integer | null Formato: int64
_subnets numero di subnet di riferimento
- targetTipo: string | null
targetin un array POST
- 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/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "explodingtopics.com",
"internal_list_limit": 10,
"include_subdomains": true,
"backlinks_filters": [
"dofollow",
"=",
true
],
"backlinks_status_type": "all"
}
]'
{
"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": [
{
"target": null,
"first_seen": null,
"lost_date": null,
"rank": null,
"backlinks": null,
"backlinks_spam_score": null,
"crawled_pages": null,
"info": {
"server": null,
"cms": null,
"platform_type": [
"[Max Depth Exceeded]"
],
"ip_address": null,
"country": null,
"is_ip": null,
"target_spam_score": null
},
"internal_links_count": null,
"external_links_count": null,
"broken_backlinks": null,
"broken_pages": null,
"referring_domains": null,
"referring_domains_nofollow": null,
"referring_main_domains": null,
"referring_main_domains_nofollow": null,
"referring_ips": null,
"referring_subnets": null,
"referring_pages": null,
"referring_pages_nofollow": null,
"referring_links_tld": null,
"referring_links_types": null,
"referring_links_attributes": null,
"referring_links_platform_types": null,
"referring_links_semantic_locations": null,
"referring_links_countries": null
}
]
}
]
}