v0.2.0-beta

OpenAPI 3.1.0

Pagine del dominio

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operazioni

post/v1/beta/dataforseo/backlinks/domain_pages/live

Pagine del dominio

Le pagine di un target con link in entrata, con la vista del crawler su ciascuna: main_domain, domain, tld, page, ip, first_visited, prev_visited e fetch_time. Serve a scoprire quali pagine guadagnano davvero link. Per i conteggi dei backlink per pagina anziché i metadati di scansione usare post_dataforseo_backlinks_domain_pages_summary_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.

Corpo

application/json

Tipo: array (object | null)[]
- backlinks_filters
  Tipo: array (object | null)[] | null
  
  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 del target
  è 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
- backlinks_status_type
  Tipo: string | null
  
  imposta quali backlink restituire e conteggiare
  campo facoltativo
  è possibile usare questo campo per scegliere quali backlink verranno restituiti e usati per le metriche aggregate;
  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
- exclude_internal_backlinks
  Tipo: boolean | null
  
  indica se i backlink interni dai sottodomini al target verranno esclusi dai risultati
  campo facoltativo
  se impostato su true, i risultati non includeranno dati sui backlink interni dai sottodomini dello stesso dominio del target
  se impostato su false, i link interni verranno inclusi nei risultati
  valore predefinito: true
- filters
  Tipo: 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 logico and o or
  sono supportati i seguenti operatori:
  regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  con l'operatore % in like e not_like è possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
  esempio:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  l'elenco completo dei filtri possibili è disponibile qui.
  
  Oggetto vuoto
- include_subdomains
  Tipo: boolean | null
  
  indica se i sottodomini del target verranno inclusi nella ricerca
  campo facoltativo
  se impostato su false, i sottodomini verranno ignorati
  valore predefinito: true
- internal_list_limit
  Tipo: integer | null
  
  numero massimo di elementi negli array interni
  campo facoltativo
  è possibile usare questo campo per limitare il numero di elementi nei seguenti array:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  valore predefinito: 10
  valore massimo: 1000
- limit
  Tipo: integer | null
  
  numero massimo di pagine restituite
  campo facoltativo
  valore predefinito: 100
  valore massimo: 1000
- offset
  Tipo: integer | null
  
  offset nell'array dei risultati delle pagine restituite
  campo facoltativo
  valore predefinito: 0
  se si specifica il valore 10, le prime dieci pagine nell'array dei risultati vengono omesse e i dati vengono forniti per le pagine successive
- order_by
  Tipo: array string[] | null
  
  regole di ordinamento dei risultati
  campo facoltativo
  è possibile usare gli stessi valori dell'array filters per ordinare i risultati
  tipi di ordinamento possibili:
  asc - i risultati vengono ordinati in ordine crescente
  desc - i risultati vengono ordinati in ordine decrescente
  il tipo di ordinamento si imposta con una virgola
  esempio:
  ["page_summary.backlinks,desc"]
  nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
  per separare più regole di ordinamento usare una virgola
  esempio:
  ["page_summary.backlinks,desc","page_summary.rank,asc"]
- rank_scale
  Tipo: string | null
  
  definisce la scala utilizzata per calcolare e visualizzare i valori rank, domain_from_rank e page_from_rank
  campo facoltativo
  
  con 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–100
  one_thousand — i valori di rank vengono visualizzati su una scala 0–1000
  
  valore predefinito: one_thousand
  
  scopri di più sul funzionamento di questo parametro e sul calcolo delle metriche di ranking in questo articolo del Help Center
- tag
  Tipo: 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 valore tag specificato si trova nell'oggetto data della risposta
- target
  Tipo: string
  
  dominio o sottodominio
  campo obbligatorio
  un dominio o un sottodominio va specificato senza https:// e www.
  esempio:
  forbes.com

Risposte

200
Tipo: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

status_code
Tipo: integer | null

codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

tasks
Tipo: array (object | null)[] | null

array di attività

Tipo: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveTaskInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

data
Tipo: object | null

Contiene gli stessi parametri specificati nella richiesta POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

path
Tipo: array (string | null)[] | null

Percorso URL

result
Tipo: array (object | null)[] | null

array di risultati

items
Tipo: array (object | null)[] | null

array di elementi

content_encoding
Tipo: string | null

tipo di codifica

domain
Tipo: string | null

dominio
dominio in cui è stata trovata la pagina

encoded_size
Tipo: integer | null

dimensione della pagina dopo la codifica
indica la dimensione della pagina codificata, in byte

fetch_time
Tipo: string | null

data e ora più recenti in cui il nostro crawler ha visitato la pagina
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2017-01-24 13:20:59 +00:00

first_visited
Tipo: string | null

data e ora della prima visita alla pagina
data e ora in cui il nostro crawler ha visitato questa pagina per la prima volta
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2017-01-24 13:20:59 +00:00

ip
Tipo: string | null

indirizzo Internet Protocol

location
Tipo: string | null

header Location
indica l'URL a cui reindirizzare una pagina, se presente

main_domain
Tipo: string | null

dominio principale del sito web
il dominio principale del sito web non include i sottodomini

media_type
Tipo: string | null

tipi di media usati per visualizzare una pagina

meta
Tipo: object | null · Response36Afe1097B20_BacklinksPageMeta

metadati della pagina

canonical
Tipo: string | null

pagina canonica

charset
Tipo: string | null

codifica dei caratteri
esempi:
utf-8

external_links_count
Tipo: integer | null Formato: int64

numero di link esterni sulla pagina

h1
Tipo: array (string | null)[] | null

tag h1
contenuto dei tag h1

h2
Tipo: array (string | null)[] | null

tag h2
contenuto dei tag h2

h3
Tipo: array (string | null)[] | null

tag h3
contenuto dei tag h3

images_alt
Tipo: array (string | null)[] | null

contenuto dei tag alt

images_count
Tipo: integer | null Formato: int64

numero di immagini sulla pagina

internal_links_count
Tipo: integer | null Formato: int64

numero di link interni sulla pagina

language
Tipo: string | null

lingua del contenuto della pagina
esempio:
en

page_spam_score
Tipo: integer | null

punteggio spam della pagina
scopri di più su come viene calcolata questa metrica in questa pagina del Help Center

platform_type
Tipo: array (string | null)[] | null

tipo di piattaforma

powered_by
Tipo: array (string | null)[] | null

dettagli CMS

social_media_tags
Tipo: object | null
propertyName
Tipo: string | null
technologies
Tipo: object | null

tecnologie del sito web

propertyName
Tipo: string | null
title
Tipo: string | null

titolo della pagina

words_count
Tipo: integer | null Formato: int64

numero di parole sulla pagina

page
Tipo: string | null

URL della pagina
URL della pagina pertinente

page_summary
Tipo: object | null · Response36Afe1097B20_PageSummary

contiene i dati sui backlink di questa pagina

backlinks
Tipo: integer | null Formato: int64

indica il numero di backlink

backlinks_spam_score
Tipo: integer | null Formato: int64

punteggio spam medio dei backlink che puntano alla pagina
scopri di più su come viene calcolata questa metrica in questa pagina del Help Center

broken_backlinks
Tipo: integer | null Formato: int64

numero di backlink interrotti
numero di backlink interrotti che puntano alla page

broken_pages
Tipo: integer | null

numero di pagine interrotte
numero di pagine a cui puntano i backlink che rispondono con codici di stato 4xx o 5xx

first_seen
Tipo: string | null

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

lost_date
Tipo: string | null

data e ora in cui è stato perso l'ultimo backlink di questa pagina
indica la data e l'ora in cui il nostro crawler ha visitato la pagina e questa ha risposto con un codice di stato 4xx o 5xx, oppure è stato rimosso l'ultimo backlink
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2017-01-24 13:20:59 +00:00

rank
Tipo: integer | null

rank della pagina
rank della page
rank viene 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

referring_domains
Tipo: integer | null Formato: int64

indica il numero di domini di riferimento

referring_domains_nofollow
Tipo: integer | null Formato: int64

numero di domini che puntano almeno un link nofollow alla page

referring_ips
Tipo: integer | null Formato: int64

numero di indirizzi IP di riferimento
numero di indirizzi IP che puntano a questa pagina

referring_links_attributes
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_countries
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_tld
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_types
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_main_domains
Tipo: integer | null Formato: int64

indica il numero di domini principali di riferimento

referring_main_domains_nofollow
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_pages
Tipo: integer | null Formato: int64

indica il numero di pagine che puntano alla page

referring_pages_nofollow
Tipo: integer | null Formato: int64

numero di pagine di riferimento che puntano almeno un link nofollow alla page

referring_subnets
Tipo: integer | null Formato: int64

numero di subnet di riferimento

prev_visited
Tipo: string | null

precedente alla data più recente in cui il nostro crawler ha visitato la pagina
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2017-01-24 13:20:59 +00:00

server
Tipo: string | null

versione del server

size
Tipo: integer | null

indica la dimensione della pagina, in byte

status_code
Tipo: integer | null

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

tld
Tipo: string | null

dominio di primo livello
dominio di primo livello nella zona root DNS

type
Tipo: string | null

tipo di elemento

items_count
Tipo: integer | null Formato: int64

numero di elementi nell'array items

target
Tipo: string | null

target in un array POST

total_count
Tipo: integer | null Formato: int64

numero totale di elementi pertinenti nel database

result_count
Tipo: integer | null Formato: int64

Numero di elementi nell'array dei risultati

status_code
Tipo: integer | null

codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

time
Tipo: string | null

Tempo di esecuzione in secondi

tasks_count
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks

tasks_error
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks restituite con un errore

time
Tipo: string | null

tempo di esecuzione totale, secondi

version
Tipo: string | null

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

post/v1/beta/dataforseo/backlinks/domain_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

Mostra schema

{
  "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,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Pagine del dominio

AutenticazioneRequired

DataForSEO

Pagine del dominio

Riferimento prezzi