v0.2.0-beta

OpenAPI 3.1.0

Riepilogo 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_summary/live

Riepilogo pagine del dominio

Metriche dei backlink per pagina per un target: una riga per url con rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks e broken_pages. Il gemello a livello di pagina di post_dataforseo_backlinks_summary_live, che riporta le stesse metriche per il dominio nel suo complesso. Per i metadati di scansione di quelle pagine usare invece post_dataforseo_backlinks_domain_pages_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
  
  filtrare i backlink del target
  campo facoltativo
  è possibile usare questo campo per filtrare i backlink iniziali che verranno inclusi nel set di dati per le metriche aggregate del target
  è possibile filtrare i backlink per tutti i campi disponibili nella risposta di questo endpoint
  usando questo parametro è possibile includere nella risposta solo backlink dofollow e creare un set di dati 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 dei sottodomini del target vengono esclusi
  campo facoltativo
  se impostato su false, i backlink dai sottodomini del dominio target verranno omessi e non si riceverà lo stesso dominio nella risposta;
  valore predefinito: true
- filters
  Tipo: array (object | null)[] | null
  
  array di parametri per il filtraggio dei risultati
  campo facoltativo
  è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
  tra le condizioni è necessario impostare un operatore logico and, or
  sono supportati i seguenti operatori:
  regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  con l'operatore % è possibile usare like e not_like per trovare qualsiasi stringa di zero o più caratteri
  esempio:
  ["referring_links_types.anchors",">","1"]
  
  [["broken_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"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 dominio 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
  
  il numero massimo di anchor restituiti
  campo facoltativo
  valore predefinito: 100
  valore massimo: 1000
- offset
  Tipo: integer | null
  
  offset nell'array dei risultati degli anchor restituiti
  campo facoltativo
  valore predefinito: 0
  se si specifica il valore 10, i primi dieci anchor nell'array dei risultati verranno saltati e i dati verranno forniti per gli anchor successivi
- 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 dati di riepilogo
  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_BacklinksDomainPagesSummaryLiveResponseInfo
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_BacklinksDomainPagesSummaryLiveTaskInfo
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

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 pagina

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 per la prima volta un backlink a questa pagina
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 a 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 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 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 che fanno riferimento alla pagina

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

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, footer

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

referring_main_domains_nofollow
Tipo: integer | null Formato: int64

numero di domini principali che puntano almeno un link nofollow alla page

referring_pages
Tipo: integer | null Formato: int64

indica il numero di pagine che puntano all'url pertinente

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

type
Tipo: string | null

tipo di elemento

url
Tipo: string | null

URL della pagina

items_count
Tipo: integer | null Formato: int64

numero di elementi nell'array dei risultati

target
Tipo: string | null

target nell'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_summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 4,
    "order_by": [
      "backlinks,desc"
    ]
  }
]'

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,
              "url": 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

Riepilogo pagine del dominio

AutenticazioneRequired

DataForSEO

Riepilogo pagine del dominio

Riferimento prezzi