v0.2.0-beta

OpenAPI 3.1.0

OnPage API: risorse

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/resources

OnPage API: risorse

Le risorse non di pagina trovate da un crawl – immagini, script, fogli di stile – con i relativi codici di stato e dimensioni. Pagine con search_after_token. Legge un crawl completato, quindi richiede l'id da post_dataforseo_on_page_submit e restituisce crawl_progress più un crawl_status tra max_crawl_pages, pages_in_queue e pages_crawled: controllali prima di fidarti di un risultato scarno, perché un crawl ancora in corso ha semplicemente meno da riportare. Per le risorse che il crawler non è riuscito a raggiungere affatto usa post_dataforseo_on_page_uncrawlable_resources. 💰 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.

Corpo

application/json

Tipo: array (object | null)[]
- filters
  Tipo: array (object | null)[] | null
  
  array di parametri per il filtraggio dei risultati
  campo facoltativo
  puoi aggiungere più filtri contemporaneamente (massimo 8 filtri)
  tra le condizioni devi impostare un operatore logico and, or
  sono supportati i seguenti operatori:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  puoi usare l'operatore % con like e not_like per trovare qualsiasi stringa di zero o più caratteri
  esempio:
  ["resource_type","=","stylesheet"]
  
  [["resource_type","=","image"], "and",["checks.is_https","=",false]]
  
  [["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]
  
  l'elenco completo dei filtri possibili è disponibile a questo link.
  
  Oggetto vuoto
- id
  Tipo: string
  
  ID dell'attività
  campo obbligatorio
  puoi ottenere questo ID nella risposta dell'endpoint Task POST
  esempio:
  "07131248-1535-0216-1000-17384017ad04"
- limit
  Tipo: integer | null
  
  il numero massimo di risorse restituite
  campo facoltativo
  valore predefinito: 100
  valore massimo: 1000
- offset
  Tipo: integer | null
  
  offset nell'array dei risultati delle risorse restituite
  campo facoltativo
  valore predefinito: 0
  valore massimo: 2000000
  se specifichi il valore 10, le prime dieci risorse nell'array dei risultati vengono omesse e i dati vengono forniti per le risorse successive
- order_by
  Tipo: array string[] | null
  
  regole di ordinamento dei risultati
  campo facoltativo
  puoi 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
  devi usare una virgola per impostare un tipo di ordinamento
  esempio:
  ["size,desc"]
  nota che puoi impostare non più di tre regole di ordinamento in una singola richiesta
  devi usare una virgola per separare più regole di ordinamento
  esempio:
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  Tipo: array string[] | null
  
  filtra le risorse per pagine pertinenti
  campo facoltativo
  puoi usare questo campo per ottenere risorse da pagine corrispondenti ai parametri definiti
  puoi applicare qui gli stessi filtri disponibili per l'endpoint pages
  puoi aggiungere più filtri contemporaneamente (massimo 8 filtri)
  tra le condizioni devi impostare un operatore logico and, or
  sono supportati i seguenti operatori:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  puoi usare l'operatore % con like e not_like per trovare qualsiasi stringa di zero o più caratteri
  esempio:
  ["checks.no_image_title","=",true]
- search_after_token
  Tipo: string | null
  
  token per le richieste successive
  campo facoltativo
  fornito nel campo identico della risposta a ogni richiesta;
  usare questo parametro per evitare timeout quando si cercano più di 20,000 risultati in un'unica richiesta;
  specificando il valore univoco search_after_token dell'array di risposta, si ottengono i risultati successivi dell'attività iniziale;
  i valori search_after_token sono univoci per ogni attività successiva;
  Nota: se nella richiesta è specificato search_after_token, tutti gli altri parametri devono essere identici alla richiesta precedente
- 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
- url
  Tipo: string | null
  
  URL della pagina
  campo facoltativo
  specifica questo campo se vuoi ottenere le risorse per una pagina specifica
  nota che per ottenere il meta di una risorsa da un determinato URL devi specificare l'URL in questo campo;
  se non indichi un url durante l'impostazione di un'attività, il meta della risorsa nei risultati verrà restituito in base ai dati della pagina in cui il nostro crawler ha visto per la prima volta la risorsa

Risposte

200
Tipo: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
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_OnPageResourcesTaskInfo
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_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

current_offset
Tipo: integer | null

Integer numbers.

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

array di elementi

cache_control
Tipo: object | null · Response36Afe1097B20_CacheControl

istruzioni per la cache

cachable
Tipo: boolean | null

indica se la pagina è memorizzabile in cache

ttl
Tipo: integer | null

time to live. il tempo per cui il browser memorizza una risorsa nella cache

checks
Tipo: object | null

controlli del sito. controlli on-page relativi alla pagina

propertyName
Tipo: boolean | null
content_encoding
Tipo: string | null

tipo di codifica

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 in cui è stata recuperata una risorsa. in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”. esempio: 2019-11-15 12:57:46 +00:00

last_modified
Tipo: object | null · Response36Afe1097B20_LastModified

contiene i dati sulle modifiche relative alla risorsa. se non ci sono dati, il valore sarà null

header
Tipo: string | null

data e ora in cui l'intestazione è stata modificata l'ultima volta nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”; esempio: 2019-11-15 12:57:46 +00:00; se non ci sono dati, il valore è null

meta_tag
Tipo: string | null

data e ora in cui il meta tag è stato modificato l'ultima volta nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”; esempio: 2019-11-15 12:57:46 +00:00; se non ci sono dati, il valore è null

sitemap
Tipo: string | null

data e ora in cui la sitemap è stata modificata l'ultima volta nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”; esempio: 2019-11-15 12:57:46 +00:00; se non ci sono dati, il valore è null

location
Tipo: string | null

header location. indica l'URL a cui reindirizzare una pagina

media_type
Tipo: string | null

tipi di media usati per visualizzare una pagina

resource_errors
Tipo: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

errori e avvisi della risorsa

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

errori delle risorse

column
Tipo: integer | null

colonna in cui è stato trovato l'errore

line
Tipo: integer | null

riga in cui è stato trovato l'errore

message
Tipo: string | null

messaggio di testo dell'errore: l'elenco completo dei possibili errori HTML è disponibile qui

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 per gestire le relative condizioni di eccezione o errore

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

avvisi delle risorse

column
Tipo: integer | null

colonna in cui è stato trovato l'errore

line
Tipo: integer | null

riga in cui è stato trovato l'errore

message
Tipo: string | null

messaggio di testo dell'errore: l'elenco completo dei possibili errori HTML è disponibile qui

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 per gestire le relative condizioni di eccezione o errore

resource_type
Tipo: string | null

tipo di elemento

server
Tipo: string | null

versione del server

size
Tipo: integer | null

dimensione della risorsa. indica la dimensione di una 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 per gestire le relative condizioni di eccezione o errore

total_transfer_size
Tipo: integer | null Formato: int64

dimensione compressa della pagina. indica la dimensione compressa di una pagina

url
Tipo: string | null

URL della pagina

items_count
Tipo: integer | null Formato: int64

numero di elementi nell'array dei risultati

search_after_token
Tipo: string | null
total_items_count
Tipo: integer | null Formato: int64

numero totale di elementi pertinenti sottoposti a scansione

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/resources

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "resource_type",
        "=",
        "image"
      ],
      "and",
      [
        "size",
        ">",
        100000
      ]
    ],
    "order_by": [
      "size,desc"
    ],
    "limit": 10
  }
]'

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
          },
          "search_after_token": null,
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "resource_type": null,
              "status_code": null,
              "location": null,
              "url": null,
              "resource_errors": "[Max Depth Exceeded]",
              "size": null,
              "encoded_size": null,
              "total_transfer_size": null,
              "fetch_time": null,
              "cache_control": "[Max Depth Exceeded]",
              "checks": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "last_modified": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

OnPage API: risorse

AutenticazioneRequired

DataForSEO

OnPage API: risorse

Riferimento prezzi