v0.2.0-beta

OpenAPI 3.1.0

OnPage API: riepilogo

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

get/v1/beta/dataforseo/on_page/summary/{id}

OnPage API: riepilogo

Lo stato e le metriche principali di un crawl, per id. Restituisce crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info e page_metrics. Racchiuso nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200. Questo è anche il modo per sapere che un crawl è terminato: esegui il polling finché crawl_progress non è finished prima di leggere qualsiasi altro endpoint qui, altrimenti leggerai risultati parziali che sembrano reali. 💰 Gratuito a monte: interrogare un crawl completato non costa nulla, solo il crawl stesso.

Riferimento prezzi

Misurazione: costo della risposta comunicato.
Stima di riferimento per richiesta: USD 0.012.
Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di percorso

id
Tipo: string
obbligatorio

identificatore dell'attività
campo obbligatorio
puoi ottenere questo ID nella risposta dell'endpoint Task POST
esempio:
“07131248-1535-0216-1000-17384017ad04”

Risposte

200
Tipo: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo
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_OnPageSummaryTaskInfo
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

crawl_gateway_address
Tipo: string | null

indirizzo IP del crawler
mostra l'indirizzo IP usato dal crawler per avviare la sessione di scansione corrente
l'elenco completo degli IP usati dal nostro crawler è disponibile nella sezione Panoramica

crawl_progress
Tipo: string | null

stato della sessione di scansione
valori possibili: in_progress, finished

crawl_status
Tipo: object | null · Response36Afe1097B20_CrawlStatusInfo

dettagli della sessione di scansione

max_crawl_pages
Tipo: integer | null Formato: int64

numero massimo di pagine da scansionare indica il limite max_crawl_pages specificato durante l'impostazione di un'attività

pages_crawled
Tipo: integer | null Formato: int64

numero di pagine scansionate

pages_in_queue
Tipo: integer | null Formato: int64

numero di pagine attualmente in coda per la scansione

crawl_stop_reason
Tipo: string | null

motivo per cui la scansione è stata interrotta
informazioni sul motivo per cui il processo di scansione è stato interrotto;
valori possibili:
limit_exceeded - è stato superato il limite impostato in max_crawl_pages;
empty_queue - tutte le URL in coda sono state sottoposte a scansione;
force_stopped - il processo di scansione è stato interrotto con la funzione On Page API Force Stop;
unexpected_exception - si è verificato un errore interno durante la scansione del target; contatta il supporto per ulteriori informazioni

domain_info
Tipo: object | null · Response36Afe1097B20_DomainInfo

informazioni a livello di dominio
informazioni on-page sul dominio di destinazione e sul processo di scansione

canonicalization_status_code
Tipo: integer | null

codice di stato restituito da una pagina canonicalizzata
il controllo del comportamento del server quando il nostro crawler tenta di accedere al sito web tramite IP;
nella maggior parte dei casi, si consiglia che le pagine canonicalizzate rispondano con un codice di stato 301 o 302

checks
Tipo: object | null

controlli del sito web
altri controlli on-page relativi al sito web

propertyName
Tipo: boolean | null
cms
Tipo: string | null

content management system
content management system rilevato su un sito web
il contenuto del meta tag generator
i dati provengono dalla prima pagina casuale che restituisce il codice di risposta 200
se il nostro crawler non è riuscito a identificare il CMS, il valore è null

crawl_end
Tipo: string | null

ora di fine della scansione
data e ora in cui la scansione è stata completata
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00
Nota: informativo solo se "crawl_progress" è "finished"
se "crawl_progress" è in_progress, il valore sarà null

crawl_start
Tipo: string | null

ora di inizio della scansione
data e ora in cui il sito web è stato inviato per la scansione
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

directory_browsing_status_code
Tipo: integer | null

codice di stato restituito da una directory
il codice di stato restituito da una pagina di directory su un sito web di destinazione
nella maggior parte dei casi, si consiglia che le directory rispondano con un codice di stato 403 o 401

extended_crawl_status
Tipo: string | null

stato e errori della scansione
indica il motivo per cui un sito web non è stato scansionato;
può assumere i seguenti valori:
no_errors - non sono stati rilevati errori di scansione;
site_unreachable - il nostro crawler non è riuscito a raggiungere un sito web e quindi non è riuscito a ottenere un codice di stato;
invalid_page_status_code - codice di stato della prima pagina scansionata >= 400;
forbidden_meta_tag - la prima pagina scansionata contiene il tag <meta robots="noindex">;
forbidden_robots - robots.txt vieta la scansione della pagina;
forbidden_http_header - l'intestazione HTTP della pagina contiene "X-Robots-Tag: noindex" ;
too_many_redirects - la prima pagina scansionata ha più di 10 redirect;
unknown - il motivo è sconosciuto

ip
Tipo: string | null

indirizzo IP del dominio

main_domain
Tipo: string | null

nome del dominio radice

name
Tipo: string | null

nome del dominio

page_not_found_status_code
Tipo: integer | null

codice di stato restituito da una pagina inesistente
nella maggior parte dei casi, si consiglia che un server restituisca un codice di risposta 404

server
Tipo: string | null

server del sito web
la versione del server rilevata su un sito web
il contenuto dell'intestazione server
le informazioni provengono dalla prima pagina il cui codice di risposta è 200

ssl_info
Tipo: object | null · Response36Afe1097B20_SslInfo

informazioni sul certificato SSL
informazioni sul protocollo Secure Sockets Layer rilevato su un sito web

certificate_expiration_date
Tipo: string | null

data di scadenza del certificato SSL
la data e ora in cui il certificato SSL scade
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

certificate_hash
Tipo: string | null

hash del certificato SSL
la versione della funzione hash del certificato SSL

certificate_issuer
Tipo: string | null

autorità di certificazione SSL
l'entità che ha emesso il certificato SSL rilevato

certificate_subject
Tipo: string | null

subject del certificato SSL
l'entità associata alla chiave pubblica

certificate_version
Tipo: integer | null

versione del certificato SSL
indica la versione di X.509 utilizzata da un certificato SSL

valid_certificate
Tipo: boolean | null

validità del certificato SSL
indica se il certificato SSL rilevato su un sito web non è scaduto, sospeso, revocato o non valido

total_pages
Tipo: integer | null Formato: int64

totale pagine scansionate
il numero totale di pagine scansionate

total_uncrawlable_resources
Tipo: integer | null Formato: int64

totale risorse non scansionabili
il numero totale di risorse che non è stato possibile scansionare;
una risorsa è considerata non scansionabile quando il tipo di contenuto effettivo della risorsa non corrisponde al tipo di contenuto previsto dal crawler

www_redirect_status_code
Tipo: integer | null

codice di stato del redirect
il codice di stato del redirect da www a non-www
nella maggior parte dei casi, si consiglia che il redirect restituisca un codice di stato 301

page_metrics
Tipo: object | null · Response36Afe1097B20_PageMetrics

informazioni specifiche della pagina
informazioni sulle metriche delle pagine del sito web di destinazione

broken_links
Tipo: integer | null

numero di link interrotti
numero di link interrotti in tutte le pagine sottoposte a scansione di un sito web di destinazione

broken_resources
Tipo: integer | null

numero di risorse interrotte
il numero di immagini e altre risorse con link interrotti

checks
Tipo: object | null

controlli on-page specifici della pagina

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

duplicate_content
Tipo: integer | null

numero di pagine con contenuti duplicati

duplicate_description
Tipo: integer | null

numero di pagine con descrizioni duplicate

duplicate_title
Tipo: integer | null

numero di pagine con titoli duplicati

links_external
Tipo: integer | null

numero di link esterni
il numero di link che puntano ad altri siti web

links_internal
Tipo: integer | null

numero di link interni
il numero di link che puntano ad altre pagine all'interno del sito web di destinazione

links_relation_conflict
Tipo: integer | null

numero di link presenti nel sito web di destinazione che possono avere un conflitto
ad esempio, se "links_relation_conflict": 2, il sito web di destinazione fa riferimento alla stessa fonte con almeno un link interno con l'attributo rel="nofollow" e con almeno un link dofollow

non_indexable
Tipo: integer | null

numero di pagine non indicizzabili
numero di pagine la cui indicizzazione è bloccata da Google e altri motori di ricerca tramite robots.txt, intestazioni HTTP o impostazioni dei meta tag;
puoi ottenere un elenco di URL non indicizzabili usando questo endpoint

onpage_score
Tipo: number | null

mostra quanto è ottimizzato il sito web su una scala da 100 punti
questo campo mostra quanto è ottimizzato il sito web considerando i problemi critici on-page e gli avvisi rilevati;
100 è il punteggio massimo possibile e significa che il sito web non presenta problemi critici on-page né avvisi importanti;
Nota: questo valore dipende dal numero di pagine sottoposte a scansione;
scopri di più su come viene calcolata la metrica in questo articolo del centro assistenza

redirect_loop
Tipo: integer | null

numero di catene di reindirizzamenti che iniziano e terminano allo stesso URL
numero di catene di reindirizzamenti in cui l'URL di destinazione reindirizza all'URL originale

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

get/v1/beta/dataforseo/on_page/summary/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/summary/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "crawl_gateway_address": null,
          "crawl_stop_reason": null,
          "domain_info": {
            "name": null,
            "cms": null,
            "ip": null,
            "server": null,
            "crawl_start": null,
            "crawl_end": null,
            "extended_crawl_status": null,
            "ssl_info": "[Max Depth Exceeded]",
            "checks": null,
            "total_pages": null,
            "total_uncrawlable_resources": null,
            "page_not_found_status_code": null,
            "canonicalization_status_code": null,
            "directory_browsing_status_code": null,
            "www_redirect_status_code": null,
            "main_domain": null
          },
          "page_metrics": {
            "links_external": null,
            "links_internal": null,
            "duplicate_title": null,
            "duplicate_description": null,
            "duplicate_content": null,
            "broken_links": null,
            "broken_resources": null,
            "links_relation_conflict": null,
            "redirect_loop": null,
            "onpage_score": null,
            "non_indexable": null,
            "checks": null
          }
        }
      ]
    }
  ]
}

Operazione riuscita

OnPage API: riepilogo

AutenticazioneRequired

DataForSEO

OnPage API: riepilogo

Riferimento prezzi