v0.2.0-beta

OpenAPI 3.1.0

Impostare le attività OnPage

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/on_page/task_post

Impostare le attività OnPage

Avvia un crawl di target e restituisce un id attività in tasks[0].id: quell'id è la chiave di accesso che ogni altro strumento di questa famiglia richiede, quindi conservalo. max_crawl_pages limita il crawl, start_url, max_crawl_depth, priority_urls e crawl_delay ne determinano la forma, e store_raw_html decide se post_dataforseo_on_page_raw_html avrà qualcosa da servire in seguito. Racchiuso nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200. ⚠️ Non è la solita coppia invio/recupero: il crawl è una sessione che una dozzina di altri strumenti interroga poi per id. Esegui il polling di get_dataforseo_on_page_summary finché crawl_progress non recita finished; un crawl di una pagina di example.com ha richiesto ben meno di un minuto.

Riferimento prezzi

Misurazione: costo della risposta comunicato.
Stima di riferimento per richiesta: USD 0.003.
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.

Corpo

application/json

Tipo: array (object | null)[]
- accept_language
 Tipo: string | null
 
 intestazione della lingua per l'accesso al sito web
 campo facoltativo
 tutti i formati di locale sono supportati (xx, xx-XX, xxx-XX ecc.)
 Nota: se non specifichi questo parametro, alcuni siti web potrebbero negare l'accesso; in questo caso le pagine verranno restituite con "type":"broken nell'array della risposta
- allow_subdomains
 Tipo: boolean | null
 
 includi le pagine nei sottodomini
 campo facoltativo
 imposta questo campo su true se vuoi eseguire il crawling di tutti i sottodomini di un sito web di destinazione
 valore predefinito: false
- allowed_subdomains
 Tipo: array string[] | null
 
 sottodomini da scansionare
 campo facoltativo
 specifica i sottodomini che vuoi scansionare
 esempio: ["blog.site.com", "my.site.com", "shop.site.com"]
 Nota: per usare questo parametro, il parametro allow_subdomains deve essere impostato su false;
 in caso contrario, il contenuto del campo allowed_subdomains verrà ignorato e i risultati verranno restituiti per tutti i sottodomini
- browser_preset
 Tipo: string | null
 
 preset per i parametri dello schermo del browser
 campo facoltativo
 se usi questo campo, non è necessario indicare browser_screen_width, browser_screen_height, browser_screen_scale_factor valori possibili:
 desktop, mobile, tablet il preset desktop applica i seguenti valori:browser_screen_width: 1920
 browser_screen_height: 1080
 browser_screen_scale_factor: 1 il preset mobile applica i seguenti valori:browser_screen_width: 390
 browser_screen_height: 844
 browser_screen_scale_factor: 3 il preset tablet applica i seguenti valori:browser_screen_width: 1024
 browser_screen_height: 1366
 browser_screen_scale_factor: 2
 Nota: per usare questo parametro, imposta enable_javascript o enable_browser_rendering su true
- browser_screen_height
 Tipo: integer | null
 
 altezza dello schermo del browser
 campo facoltativo
 puoi impostare un'altezza personalizzata dello schermo del browser per eseguire un audit per un dispositivo specifico;
 se usi questo campo, non è necessario indicare browser_preset, perché verrà ignorato;
 Nota: per usare questo parametro, imposta enable_javascript o enable_browser_rendering su true valore minimo, in pixel: 240
 valore massimo, in pixel: 9999
- browser_screen_scale_factor
 Tipo: number | null
 
 fattore di scala dello schermo del browser
 campo facoltativo
 puoi impostare un rapporto di risoluzione personalizzato del browser per eseguire un audit per un dispositivo specifico;
 se usi questo campo, non è necessario indicare browser_preset, perché verrà ignorato;
 Nota: per usare questo parametro, imposta enable_javascript o enable_browser_rendering su true valore minimo: 0.5
 valore massimo: 3
- browser_screen_width
 Tipo: integer | null Formato: int64
 
 larghezza dello schermo del browser
 campo facoltativo
 puoi impostare una larghezza personalizzata dello schermo del browser per eseguire un audit per un dispositivo specifico;
 se usi questo campo, non è necessario indicare browser_preset, perché verrà ignorato;
 Nota: per usare questo parametro, imposta enable_javascript o enable_browser_rendering su true valore minimo, in pixel: 240
 valore massimo, in pixel: 9999
- calculate_keyword_density
 Tipo: boolean | null
 
 calcola la densità di keyword per il dominio di destinazione
 campo facoltativo
 imposta questo campo su true se vuoi calcolare la densità di keyword per le pagine del sito web
 valore predefinito: false
 Nota: se usi questo parametro vengono applicati costi aggiuntivi; per saperne di più sul costo delle attività con questo parametro, consulta il nostro articolo di assistenza
 una volta completato il crawling, puoi ottenere i valori di densità di keyword con l'endpoint Keyword Density
- check_spell
 Tipo: boolean | null
 
 controlla l'ortografia
 campo facoltativo
 imposta questo campo su true per controllare l'ortografia di un sito web usando la libreria Hunspell
 valore predefinito: false
- check_spell_exceptions
 Tipo: array string[] | null
 
 parole escluse dal controllo ortografico
 campo facoltativo
 specifica le parole che vuoi escludere dal controllo ortografico
 lunghezza massima delle parole: 100 caratteri
 quantità massima di parole: 1000
 esempio: "SERP", "minifiers", "JavaScript"
- check_spell_language
 Tipo: string | null
 
 lingua del controllo ortografico
 campo facoltativo
 lingue supportate: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
 Nota: se non viene specificata una lingua, verrà impostata automaticamente in base al contenuto della pagina
- checks_threshold
 Tipo: object | null
 
 soglie personalizzate per i controlli
 campo facoltativo
 puoi specificare soglie personalizzate per i parametri inclusi nell'oggetto checks delle risposte di OnPage API;
 Nota: è possibile modificare solo soglie con valori interi;
 ad esempio, i parametri high_loading_time e large_page_size sono impostati per impostazione predefinita rispettivamente su 3 secondi e 1 megabyte;
 se vuoi cambiare queste soglie in 1 secondo e 1000 kbytes, usa il seguente snippet:
 "checks_threshold": { "high_loading_time": 1, "large_page_size": 1000 }
 parametri personalizzabili con valori predefiniti:
 "title_too_short", default value: 30, type: "int" "title_too_long", default value: 65, type: "int" "small_page_size", default value: 1024, type: "int" "large_page_size", default value: 1048576 (1024 * 1024), type: "int" "low_character_count", default value: 1024, type: "int" "high_character_count", default value: 256000 (250 * 1024), type: "int" "low_content_rate", default value: 0.1, type: "float" "high_content_rate", default value: 0.9, type: "float" "high_loading_time", default value: 3000, type: "int" "high_waiting_time", default value: 1500, type: "int" "low_readability_rate", default value: 15.0, type: "float" "irrelevant_description", default value: 0.2, type: "float" "irrelevant_title", default value: 0.3, type: "float" "irrelevant_meta_keywords", default value: 0.6, type: "float"
 
 propertyName
 Tipo: integer | null Formato: int64
 
 Signed 64-bit integers (long type).
- crawl_delay
 Tipo: integer | null
 
 ritardo tra le richieste, ms
 campo facoltativo
 il ritardo personalizzato tra le richieste del crawler al server
 valore predefinito: 2000
- crawl_sitemap_only
 Tipo: boolean | null
 
 scansiona solo le pagine indicate nella sitemap
 campo facoltativo
 impostare su true se si vogliono scansionare solo le pagine indicate nella sitemap
 se si imposta questo parametro su true e non si specifica custom_sitemap, verrà scansionata la sitemap predefinita
 valore predefinito: false
 Nota: per usare questo parametro, respect_sitemap deve essere true
- custom_js
 Tipo: string | null
 
 javascript personalizzato
 campo facoltativo
 Nota: il tempo di esecuzione dello script inserito qui deve essere al massimo di 700 ms; ad esempio, è possibile usare il seguente snippet JS per verificare se il sito contiene Google Tag Manager come attributo scr:
 let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;il valore restituito dipende da quanto specificato in questo campo. Ad esempio, se si specifica il seguente script:
 meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
 come risposta si riceveranno i seguenti dati:
 "custom_js_response": { "url": "https://dataforseo.com/", "test": "test" }
 Nota: la lunghezza dello script inserito non deve superare i 2000 caratteri
- custom_robots_txt
 Tipo: string | null
 
 impostazioni personalizzate di robots.txt
 campo facoltativo
 esempio: Disallow: /directory1/
- custom_sitemap
 Tipo: string | null
 
 URL della sitemap personalizzata
 campo facoltativo
 l'URL della pagina in cui si trova la sitemap alternativa
 Nota: per usare questo parametro, respect_sitemap deve essere true
- custom_user_agent
 Tipo: string | null
 
 user agent personalizzato
 campo facoltativo
 user agent personalizzato per il crawling di un sito web
 esempio: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
 valore predefinito: Mozilla/5.0 (compatible; RSiteAuditor)
- disable_cookie_popup
 Tipo: boolean | null
 
 disattiva il popup dei cookie
 campo facoltativo
 impostare su true se si vuole disattivare il popup che richiede il consenso ai cookie all'utente;
 valore predefinito:
 false
- disable_page_checks
 Tipo: array string[] | null
 
 impedisci l'esecuzione di determinati controlli della pagina
 campo facoltativo
 specificare determinati checks per impedirne l'esecuzione e l'impatto sul onpage_score. esempio:
 "disable_page_checks": ["is_5xx_code", "is_4xx_code"]
- disable_sitewide_checks
 Tipo: array string[] | null
 
 impedisci l'esecuzione di determinati controlli a livello di sito
 campo facoltativo
 specificare i seguenti checks per impedirne l'esecuzione sul sito target:
 "test_page_not_found"
 "test_canonicalization"
 "test_https_redirect"
 "test_directory_browsing"esempio:
 "disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]scopri di più nel nostro Help Center
- disallowed_subdomains
 Tipo: array string[] | null
 
 sottodomini da non scansionare
 campo facoltativo
 specificare i sottodomini che non si desidera scansionare
 esempio: ["status.site.com", "docs.site.com"]
 Nota: per usare questo parametro, il parametro allow_subdomains deve essere impostato su true
- enable_browser_rendering
 Tipo: boolean | null
 
 emula il rendering del browser per misurare i Core Web Vitals
 campo facoltativo
 usando questo parametro sarà possibile emulare un browser durante il caricamento di una pagina web;
 enable_browser_rendering carica stili, immagini, font, animazioni, video e altre risorse di una pagina;
 valore predefinito: false
 impostare su true per ottenere le metriche Core Web Vitals (FID, CLS, LCP) nella risposta;
 se si usa questo campo, i parametri enable_javascript e load_resources devono essere impostati su true
 Nota: se si usa questo parametro, verranno applicati costi aggiuntivi; scopri di più sul costo delle attività con questo parametro nel nostro articolo di assistenza; il costo può essere calcolato nella pagina Pricing
- enable_content_parsing
 Tipo: boolean | null
 
 analizza il contenuto delle pagine scansionate
 campo facoltativo
 impostare su true per usare l'endpoint OnPage Content Parsing
 valore predefinito: false
- enable_javascript
 Tipo: boolean | null
 
 carica javascript su una pagina
 campo facoltativo
 impostare su true se si vogliono caricare gli script disponibili su una pagina
 valore predefinito: false
 Nota: se si usa questo parametro, verranno applicati costi aggiuntivi; scopri di più sul costo delle attività con questo parametro nel nostro articolo di assistenza; il costo può essere calcolato nella pagina Pricing
- enable_www_redirect_check
 Tipo: boolean | null
 
 verifica se il dominio ha implementato il reindirizzamento www
 campo facoltativo
 impostare su true se si vuole verificare se il dominio richiesto ha implementato il reindirizzamento da www a non-www o da non-www a www;
 valore predefinito: false
- enable_xhr
 Tipo: boolean | null
 
 abilita XMLHttpRequest su una pagina
 campo facoltativo
 impostare su true se si desidera che il nostro crawler richieda dati a un server web usando l'oggetto XMLHttpRequest
 valore predefinito: false;se si usa questo campo, enable_javascript deve essere impostato su true;
- force_sitewide_checks
 Tipo: boolean | null
 
 abilita i controlli a livello di sito durante la scansione di una singola pagina
 campo facoltativo
 impostare su true per ottenere dati sui controlli a livello di sito durante la scansione di una singola pagina;
 valore predefinito: false
- load_resources
 Tipo: boolean | null
 
 carica risorse
 campo facoltativo
 impostare su true se si vogliono caricare immagini, fogli di stile, script e risorse non funzionanti
 valore predefinito: false
 Nota: se si usa questo parametro, verranno applicati costi aggiuntivi; scopri di più sul costo delle attività con questo parametro nel nostro articolo di assistenza; il costo può essere calcolato nella pagina Pricing
- max_crawl_depth
 Tipo: integer | null
 
 profondità di crawl
 campo facoltativo
 la profondità di collegamento delle pagine da scansionare;
 ad esempio, la pagina iniziale della scansione è il livello 0, le pagine con link da quella pagina sono il livello 1 e così via.
- max_crawl_pages
 Tipo: integer
 
 limite di pagine scansionate
 campo obbligatorio
 il numero di pagine da scansionare sul dominio specificato
 Nota:
 se si imposta max_crawl_pages su 1 e non si specifica start_url o si imposta in esso una pagina iniziale, i seguenti controlli a livello di sito verranno disattivati:
 test_canonicalization, enable_www_redirect_check, test_hidden_server_signature, test_page_not_found, test_directory_browsing, test_https_redirect
 per abilitarli comunque, impostare force_sitewide_checks su truese si imposta max_crawl_pages su 1 e si specifica una start_url diversa da una pagina iniziale, tutti i controlli a livello di sito verranno disattivati;
 per abilitarli comunque, impostare force_sitewide_checks su true
- pingback_url
 Tipo: string | null
 
 URL di notifica di un'attività completata
 campo facoltativo
 al completamento di un'attività ti invieremo una notifica tramite una richiesta GET all'URL specificato
 puoi usare la stringa ‘$id’ come variabile $id e ‘$tag’ come variabile $tag codificata per URL. Imposteremo i valori necessari prima di inviare la richiesta.
 esempio:
 http://your-server.com/pingscript?id=$id
 http://your-server.com/pingscript?id=$id&tag=$tag
 Nota: i caratteri speciali in pingback_url vengono codificati per URL;
 ad es. il carattere # viene codificato in %23
 
 per saperne di più, consulta il nostro Help Center
- priority_urls
 Tipo: array string[] | null
 
 URL da scansionare saltando la coda
 campo facoltativo
 gli URL specificati in questo array verranno scansionati per primi, saltando la coda di scansione;
 Nota: è necessario specificare l'URL assoluto;
 è possibile specificare fino a 20 URL;
 tutti gli URL nell'array devono appartenere al dominio target;
 i sottodomini verranno ignorati a meno che il parametro allow_subdomains non sia impostato su trueesempio:
 "priority_urls": [ "https://dataforseo.com/apis/serp-api", "https://dataforseo.com/contact" ]
- respect_sitemap
 Tipo: boolean | null
 
 rispetta la sitemap durante la scansione
 campo facoltativo
 impostare su true se si vuole seguire l'ordine delle pagine indicate nella sitemap principale durante la scansione;
 valore predefinito: false
 Nota: se impostato su true, il valore di click_depth nella risposta API sarà uguale a 0;
 il campo max_crawl_depth della richiesta verrà ignorato; è possibile specificare il numero di pagine da scansionare con il parametro max_crawl_pages
- return_despite_timeout
 Tipo: boolean | null
 
 restituisci dati sulle pagine nonostante l'errore di timeout
 campo facoltativo
 se true, i dati verranno forniti per le pagine che non sono riuscite a caricarsi entro 120 secondi e hanno risposto con un errore di timeout;
 valore predefinito: false
- robots_txt_merge_mode
 Tipo: string | null
 
 unisci o sovrascrivi le impostazioni di robots.txt
 campo facoltativo
 valori possibili: merge, override;
 impostare su override se si vogliono ignorare le restrizioni di scansione del sito e altre impostazioni di robots.txt
 valore predefinito: merge;
 Nota: se impostato su override, specificare il parametro custom_robots_txt
- start_url
 Tipo: string | null
 
 il primo URL da scansionare
 campo facoltativo
 Nota: è necessario specificare un URL assoluto
 se si vuole scansionare una singola pagina, specificarne l'URL in questo campo e impostare inoltre il parametro max_crawl_pages su 1
 è anche possibile usare l'endpoint live Instant Pages per ottenere dati specifici della pagina
- store_raw_html
 Tipo: boolean | null
 
 memorizza l'HTML delle pagine scansionate
 campo facoltativo
 impostare su true se si vuole ottenere l'HTML della pagina usando l'endpoint OnPage Raw HTML
 valore predefinito: false
- support_cookies
 Tipo: boolean | null
 
 supporta i cookie sulle pagine scansionate
 campo facoltativo
 impostare su true per supportare i cookie durante la scansione delle pagine
 valore predefinito: false
- switch_pool
 Tipo: boolean | null
 
 cambia pool di proxy
 campo facoltativo
 se true, verranno usati pool di proxy aggiuntivi per ottenere i dati richiesti;
 il parametro può essere usato se vengono impostate molte attività contemporaneamente, causando errori occasionali rate-limit e/o site_unreachable
- 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 di destinazione
 campo obbligatorio
 il nome di dominio deve essere specificato senza https:// e www.
 se si specifica l'URL della pagina, i risultati verranno restituiti per il dominio incluso nell'URL
- validate_micromarkup
 Tipo: boolean | null
 
 abilita la convalida dei microdati
 campo facoltativo
 impostare su true se si vuole usare l'endpoint OnPage API Microdata
 valore predefinito: false

Risposte

200
Tipo: object | null · Response36Afe1097B20_OnPageTaskPostResponseInfo
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_OnPageTaskPostTaskInfo
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: object | null

array di risultati
in questo caso il valore sarà null

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/on_page/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "max_crawl_pages": 10,
    "load_resources": true,
    "enable_javascript": true,
    "custom_js": "meta = {}; meta.url = document.URL; meta;",
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

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": null
    }
  ]
}

Operazione riuscita

Impostare le attività OnPage

AutenticazioneRequired

DataForSEO

Impostare le attività OnPage

Riferimento prezzi