v0.2.0-beta

OpenAPI 3.1.0

Domini di riferimento

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/referring_domains/live

Domini di riferimento

I domini che collegano a un target, una riga per dominio con domain, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks e broken_pages. I domini di riferimento contano più del numero grezzo di backlink, perché mille link da un solo dominio sono una sola relazione. Per i singoli link usare post_dataforseo_backlinks_backlinks_live; per comprimere ulteriormente, fino ai gestori di rete, post_dataforseo_backlinks_referring_networks_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
  
  impostare quali backlink restituire e conteggiare
  campo facoltativo
  è possibile usare questo campo per scegliere quali backlink verranno restituiti e usati per le metriche aggregate del target;
  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
- exclude_internal_backlinks
  Tipo: boolean | null
  
  indica se i backlink dai sottodomini del target sono esclusi
  campo facoltativo
  se impostato su false, i backlink dai sottodomini del target vengono omessi e non si riceve lo stesso dominio nella risposta;
  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, match, not_match
  con l'operatore % in like e not_like è possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
  esempio:
  ["referring_pages",">","1"]
  
  [["referring_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["domain","like","%dataforseo.com%"],"or",["referring_domains",">","10"]]]
  
  l'elenco completo dei filtri possibili è disponibile qui.
  
  Oggetto vuoto
- include_indirect_links
  Tipo: boolean | null
  
  indica se i link indiretti al target verranno inclusi nei risultati
  campo facoltativo
  se impostato su true, 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 su false, i link indiretti verranno ignorati
  valore predefinito: true
- 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 domini restituiti
  campo facoltativo
  valore predefinito: 100
  valore massimo: 1000
- offset
  Tipo: integer | null
  
  offset nell'array dei risultati dei domini restituiti
  campo facoltativo
  valore predefinito: 0
  se si specifica il valore 10, i primi dieci domini nell'array dei risultati verranno saltati e i dati verranno 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:
  ["backlinks,desc"]
  nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
  per separare più regole di ordinamento usare una virgola
  esempio:
  ["backlinks,desc","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, sottodominio o pagina web per cui ottenere i domini di riferimento
  campo obbligatorio
  un dominio o un sottodominio va specificato senza https:// e www.
  una pagina va specificata con URL assoluto (inclusi http:// o https://)

Risposte

200
Tipo: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveResponseInfo
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_BacklinksReferringDomainsLiveTaskInfo
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

backlinks
Tipo: integer | null Formato: int64

indica il numero di backlink che puntano al target

backlinks_spam_score
Tipo: integer | null Formato: int64

punteggio spam medio di tutti i backlink che puntano al dominio
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 al dominio

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

domain
Tipo: string | null

dominio di riferimento

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 da questo dominio
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 in cui è stato rimosso l'ultimo backlink
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2017-01-24 13:20:59 +00:00

rank
Tipo: integer | null

rank del dominio
volume di rank che un sito web di riferimento trasmette al target
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
nota che per questa metrica calcoliamo separatamente i domini principali (domini root, come example.com) e i loro sottodomini (ad es. blog.example.com)

referring_domains_nofollow
Tipo: integer | null Formato: int64

numero di domini che puntano almeno un link nofollow al target

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

attributi del link dei link di riferimento
indica gli attributi del link dei link di riferimento e il numero di link per ciascun attributo

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_countries
Tipo: object | null

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

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Tipo: object | null

tipi di piattaforme di riferimento
indica i tipi di piattaforme di riferimento e il numero di link per ciascuna piattaforma

valori possibili: cms, blogs, ecommerce, message-boards, wikis, news, organization

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Tipo: object | null

posizioni semantiche dei link di riferimento
indica gli elementi HTML semantici in cui si trovano i link di riferimento e il numero di link per ciascuna posizione semantica

l'elenco completo degli elementi semantici è disponibile qui
esempi:
article, section, summary

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_tld
Tipo: object | null

domini di primo livello dei link di riferimento
contiene i domini di primo livello e il numero di link di riferimento per ciascuno

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_types
Tipo: object | null

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

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
il numero di domini primari (root) che puntano al tuo target

referring_main_domains_nofollow
Tipo: integer | null Formato: int64

numero di domini principali che puntano almeno un link nofollow al target

referring_pages
Tipo: integer | null Formato: int64

indica il numero di pagine che puntano al target specificato

referring_pages_nofollow
Tipo: integer | null Formato: int64

numero di pagine di riferimento che puntano almeno un link nofollow al target

referring_subnets
Tipo: integer | null Formato: int64

numero di subnet di riferimento

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
numero totale di domini principali che puntano al tuo target;
example.com e blog.example.com vengono conteggiati come un unico dominio di riferimento

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/referring_domains/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "backlinko.com",
    "limit": 5,
    "order_by": [
      "rank,desc"
    ],
    "exclude_internal_backlinks": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "filters": [
      "backlinks",
      ">",
      100
    ]
  }
]'

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,
              "domain": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": 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
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Domini di riferimento

AutenticazioneRequired

DataForSEO

Domini di riferimento

Riferimento prezzi