DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Cronologia backlink
Il profilo backlink di un target come si presentava a ogni data di un intervallo, con date_from, date_to e un elemento per punto. Per il solo profilo attuale usare post_dataforseo_backlinks_summary_live. Per una serie temporale più leggera, post_dataforseo_backlinks_timeseries_summary_live riporta meno metriche per punto. 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.0271.
- 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)[]
- dateTipo: string | null
_from data di inizio dell'intervallo temporale
campo facoltativo
valore minimo2019-01-01
se non si specifica questo campo, verrà usato il valore minimo per impostazione predefinita
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - dateTipo: string | null
_to data di fine dell'intervallo di tempo
campo facoltativo
se non specifichi questo campo, verrà usata la data odierna per impostazione predefinita
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - 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
campo obbligatorio
un dominio va specificato senzahttps://ewww.
- Tipo: object | null · Response36Afe1097B20_BacklinksHistoryLiveResponseInfo200
- 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_BacklinksHistoryLiveTaskInfo
- 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
- dateTipo: string | null
_from data di inizio dell'intervallo di tempo
in formato UTC: “yyyy-mm-dd”
esempio:2019-01-01 - dateTipo: string | null
_to data di fine dell'intervallo di tempo
in formato UTC:"yyyy-mm-dd"
esempio:"2019-01-15" - itemsTipo: array (object | null)[] | null
contiene i dati storici sui backlink per il dominio specificato
i dati sono forniti mese per mese;
le metriche sono aggregate in base ai backlink che il dominio specificato aveva il primo giorno di ogni mese- backlinksTipo: integer | null Formato: int64
numero di backlink
- 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 che ricevono backlink ma rispondono con codici di stato 4xx o 5xx - crawledTipo: integer | null
_pages numero di pagine scansionate per il
target - dateTipo: string | null
data e ora in cui sono stati memorizzati i dati per il target
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - externalTipo: integer | null Formato: int64
_links _count numero di link esterni sulla pagina
calcolato come somma dei link esterni sulle pagine deltargetspecificato - 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: integer | null Formato: int64
_backlinks numero di backlink persi per il
target
i dati sono forniti sulla base di un confronto con il periodo precedente
Nota: questi dati sono disponibili da maggio 2021;
se l'intervallo di date specificato nella richiesta POST è precedente a maggio 2021, il campo sarà uguale a0 - lostTipo: integer | null Formato: int64
_referring _domains numero di domini di riferimento persi per il
target
i dati sono forniti sulla base di un confronto con il periodo precedente
Nota: questi dati sono disponibili da maggio 2021;
se l'intervallo di date specificato nella richiesta POST è precedente a maggio 2021, il campo sarà uguale a0 - newTipo: integer | null Formato: int64
_backlinks numero di nuovi backlink per il
target
i dati sono forniti sulla base di un confronto con il periodo precedente
Nota: questi dati sono disponibili da maggio 2021;
se l'intervallo di date specificato nella richiesta POST è precedente a maggio 2021, il campo sarà uguale a0 - newTipo: integer | null Formato: int64
_referring _domains numero di nuovi domini di riferimento per il
target
i dati sono forniti sulla base di un confronto con il periodo precedente
Nota: questi dati sono disponibili da maggio 2021;
se l'intervallo di date specificato nella richiesta POST è precedente a maggio 2021, il campo sarà uguale a0 - rankTipo: integer | null
- referringTipo: integer | null Formato: int64
_domains 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- 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 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 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
- typeTipo: string | null
tipo di elemento
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - targetTipo: string | null
targetdall'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/history/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "cnn.com",
"date_from": "2020-01-01",
"date_to": "2021-01-01"
}
]'
{
"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,
"date_from": null,
"date_to": null,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"rank": null,
"backlinks": null,
"new_backlinks": null,
"lost_backlinks": null,
"new_referring_domains": null,
"lost_referring_domains": null,
"crawled_pages": null,
"info": "[Max Depth Exceeded]",
"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
}
]
}
]
}
]
}