DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Intersezione di pagine
Le pagine che collegano a più URL target contemporaneamente, anziché i domini. ⚠️ targets è un oggetto indicizzato per posizione e accetta URL completi, non domini nudi. Ogni riga contiene page_intersection e un summary per target. L'equivalente a livello di dominio è post_dataforseo_backlinks_domain_intersection_live, a cui rivolgersi per primo.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.033.
- 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: string | null
_status _type imposta quali backlink restituire e conteggiare
campo facoltativo
è possibile usare questo campo per scegliere quali backlink verranno restituiti e usati per le metriche aggregate deitargets;
valori possibili:all- tutti i backlink verranno restituiti e conteggiati;live- i backlink trovati durante l'ultima verifica 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 nel risultato
valore predefinito:true - excludeTipo: array string[] | null
_targets domini, sottodomini o pagine web da escludere
campo facoltativo
è possibile impostare fino a 10 domini, sottodomini o pagine web
se si usa questo array, i risultati conterranno le pagine di riferimento che collegano atargetsma non aexclude_targets
esempio:"exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"https://dataforseo.com/apis/*"] - 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:["1.rank",">","80"][["2.page_from_rank",">","55"],
"and",
["1.original","=","true"]][["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
"and",
[["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]Oggetto vuoto - includeTipo: boolean | null
_indirect _links indica se i link indiretti ai
targetsverranno inclusi nei risultati
campo facoltativo
se impostato sutrue, i risultati includeranno dati sui link indiretti che puntano a una pagina che reindirizza a una destinazione o punta a una pagina canonica
se impostato sufalse, i link indiretti verranno ignorati
valore predefinito:true - includeTipo: boolean | null
_subdomains indica se i sottodomini dei
targetsverranno 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:attributesdomain_from_platform_typevalore predefinito:
10
valore massimo:1000 - intersectionTipo: string | null
_mode indica se intersecare i backlink
campo facoltativo
usare questo campo per intersecare o unire i risultati per gli URL specificati
valori possibili:all,partialall- i risultati si basano su tutti i backlink;partial- i risultati si basano solo sui backlink in intersezione;
valore predefinito:all - limitTipo: integer | null
il numero massimo di backlink restituiti
campo facoltativovalore predefinito:
100
valore massimo:1000 - offsetTipo: integer | null
offset nell'array dei risultati dei backlink restituiti
campo facoltativovalore predefinito:
0
se si specifica il valore10, i primi dieci backlink nell'array dei risultati verranno saltati e i dati verranno forniti per i backlink 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
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:["domain_from_rank,desc","page_from_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 - targetsTipo: object | null
domini, sottodomini o pagine web per cui ottenere i link
campo obbligatorio
è possibile impostare fino a 20 domini, sottodomini o pagine web
un dominio o un sottodominio va specificato senzahttps://ewww.
una pagina va specificata con URL assoluto (inclusihttp://ohttps://)
esempio:"targets": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}- propertyTipo: string | null
Name
- Tipo: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo200
- 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_BacklinksPageIntersectionLiveTaskInfo
- 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 dati pertinenti su backlink e domini di riferimento
- pageTipo: object | null
_intersection contiene i dati sulle pagine che collegano ai target corrispondenti specificati nell'array POST
i dati sono forniti in oggetti separati corrispondenti alle pagine specificate nell'oggettotargets- propertyTipo: array (object | null)[] | null
Name - altTipo: string | null
testo alternativo dell'immagine
questo campo sarànullse iltypedel backlink non è image - anchorTipo: string | null
testo ancora del backlink
- attributesTipo: array (string | null)[] | null
attributi del link dei link di riferimento
esempio:nofollow - backlinkTipo: integer | null
_spam _score - dofollowTipo: boolean | null
indica se il backlink è dofollow
se èfalse, il backlink è nofollow - domainTipo: string | null
_from dominio che fa riferimento al dominio o alla pagina web di destinazione
- domainTipo: string | null
_from _country codice paese ISO del dominio di riferimento
- domainTipo: string | null
_from _ip indirizzo IP del dominio di riferimento
- domainTipo: boolean | null
_from _is _ip indica se il dominio è un IP
se ètrue, il dominio funziona come indirizzo IP e non ha un nome di dominio - domainTipo: array (string | null)[] | null
_from _platform _type tipi di piattaforma del dominio di riferimento
valori possibili:
cms,blogs,ecommerce,message-boards,wikis,news,organization - domainTipo: integer | null
_from _rank rank del dominio del dominio di riferimento
indica il rank del dominio nel momento in cui il nostro crawler ha visto il backlink l'ultima volta;domain_from_rankviene calcolato in base al metodo di ranking dei nodi in un database collegato, un principio dell'originale algoritmo Google PageRank
scopri di più su questa metrica e su come viene calcolata in questo articolo del Help Center - domainTipo: string | null
_to dominio a cui punta il backlink
- firstTipo: string | null
_seen data e ora in cui il nostro crawler ha trovato il backlink per la prima volta
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - groupTipo: integer | null Formato: int64
_count indica il numero totale di backlink da questo dominio
ad esempio, semodeè impostato suone_per_domain, questo campo indica il numero totale di backlink provenienti da questo dominio - indirectTipo: array (object | null)[] | null
_link _path percorso del link indiretto
indica un URL o una sequenza di URL che portano aurl_to- statusTipo: integer | null
_code codice di stato generale
l'elenco completo dei codici di risposta è disponibile qui
Nota: consigliamo vivamente di progettare un sistema adeguato per gestire le relative condizioni eccezionali o di errore - typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL del link indiretto
- isTipo: boolean | null
_broken indica se il backlink è interrotto
se ètrue, il backlink punta a una pagina che risponde con un codice di stato 4xx o 5xx - isTipo: boolean | null
_indirect _link indica se il backlink è un link indiretto
se ètrue, il backlink è un link indiretto che punta a una pagina che reindirizza aurl_too punta a una pagina canonica - isTipo: boolean | null
_lost indica se il backlink è stato rimosso
se ètrue, sono stati rimossi il backlink o l'intera pagina - isTipo: boolean | null
_new indica se il backlink è nuovo
se ètrue, il backlink è stato trovato sulla pagina durante l'ultima visita del nostro crawler - itemTipo: string | null
_type tipo di link
valori possibili:anchor,image,link,meta,canonical,alternate,redirect - lastTipo: string | null
_seen data più recente in cui il nostro crawler ha visitato il backlink
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - linksTipo: integer | null Formato: int64
_count numero di backlink identici trovati sulla pagina di riferimento
- originalTipo: boolean | null
indica se il backlink era presente sulla pagina di riferimento quando il nostro crawler l'ha visitata per la prima volta
- pageTipo: string | null
_from _encoding codifica dei caratteri della pagina di riferimento
esempio:utf-8 - pageTipo: integer | null
_from _external _links numero di link esterni trovati sulla pagina di riferimento
- pageTipo: integer | null
_from _internal _links numero di link interni trovati sulla pagina di riferimento
- pageTipo: string | null
_from _language lingua della pagina di riferimento
in formato ISO 639-1
esempio:en - pageTipo: integer | null
_from _rank - pageTipo: integer | null
_from _size dimensione della pagina di riferimento, in byte
esempio:63357 - pageTipo: integer | null
_from _status _code codice di stato HTTP restituito dalla pagina di riferimento
esempio:200 - pageTipo: string | null
_from _title titolo della pagina di riferimento
- prevTipo: string | null
_seen precedente alla data più recente in cui il nostro crawler ha visitato il backlink
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - rankTipo: integer | null
- semanticTipo: string | null
_location - textTipo: string | null
_post snippet dopo il testo ancora
- textTipo: string | null
_pre snippet di testo prima del testo ancora
- tldTipo: string | null
_from dominio di primo livello dell'URL di riferimento
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
_from URL della pagina in cui è stato trovato il backlink
- urlTipo: boolean | null
_from _https indica se l'URL di riferimento è protetto con HTTPS
se ètrue, l'URL di riferimento è protetto con HTTPS - urlTipo: string | null
_to URL a cui punta il backlink
- urlTipo: boolean | null
_to _https indica se l'URL a cui punta il backlink è protetto con HTTPS
se ètrue, l'URL è protetto con HTTPS - urlTipo: string | null
_to _redirect _target URL di destinazione del redirect
pagina di destinazione a cui punta il redirect - urlTipo: integer | null
_to _spam _score - urlTipo: integer | null
_to _status _code codice di stato della pagina di destinazione
se il valore ènull, il nostro crawler non ha ancora visitato la pagina web a cui punta il link
esempio:200
- summaryTipo: object | null · Response36Afe1097B20_IntersectionSummaryInfo
contiene il riepilogo delle intersezioni tra pagine
- intersectionsTipo: integer | null Formato: int64
_count numero totale di intersezioni
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - targetsTipo: object | null
targetsda un array POST- propertyTipo: string | null
Name
- totalTipo: integer | null Formato: int64
_count numero totale di risultati 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/backlinks/page_intersection/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": {
"1": "football.com",
"2": "fifa.com"
},
"exclude_targets": [
"skysports.com"
],
"limit": 5,
"order_by": [
"1.rank,desc"
],
"filters": [
[
"2.domain_from_rank",
">",
400
],
"and",
[
"1.dofollow",
"=",
true
]
]
}
]'
{
"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": [
{
"targets": null,
"total_count": null,
"items_count": null,
"items": [
{
"page_intersection": null,
"summary": "[Max Depth Exceeded]"
}
]
}
]
}
]
}