> ## Documentation Index > Fetch the complete documentation index at: https://docs.olostep.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape > Trasforma qualsiasi URL in Markdown, HTML, screenshot, PDF o JSON strutturato pronti per LLM. Attraverso l'endpoint `/v1/scrapes` di Olostep puoi estrarre Markdown, HTML, testo, screenshot o JSON strutturato da qualsiasi URL in tempo reale. * Produce markdown pulito, dati strutturati, screenshot o html * Estrai JSON tramite [Parser](/features/structured-content/parsers) o [estrazione LLM](/features/structured-content/llm-extraction) * Gestisce contenuti dinamici: siti resi con js, flussi di login tramite azioni, PDF Per i dettagli dell'API vedi la [Riferimento API dell'Endpoint Scrape](/api-reference/scrapes/create). ## Scraping di un URL Usa l'endpoint `/v1/scrapes` per fare scraping di un singolo URL e scegliere i formati di output. ### Installazione ```python Python theme={null} pip install olostep ``` ```javascript Node theme={null} npm install olostep ``` ```bash cURL theme={null} # curl è disponibile di default su macOS, Linux e Windows ``` ```javascript Node (API) theme={null} npm install node-fetch ``` ```bash Python (API) theme={null} pip install requests ``` ### Utilizzo Puoi usare l'endpoint per fare scraping di un singolo URL e scegliere i formati di output. I parametri obbligatori sono `url_to_scrape` e `formats`. Altri parametri comuni sono `wait_before_scraping` (in millisecondi), `remove_css_selectors` (default, nessuno, o un array di selettori), e `country`. ```python Python theme={null} from olostep import Olostep client = Olostep(api_key="YOUR_REAL_KEY") result = client.scrapes.create( url_to_scrape="https://en.wikipedia.org/wiki/Alexander_the_Great", formats=["markdown", "html"], ) print(result.markdown_content) print(result.html_content) ``` ```js Node theme={null} import Olostep from 'olostep' const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' }) const result = await client.scrapes.create({ url: 'https://en.wikipedia.org/wiki/Alexander_the_Great', formats: ['markdown', 'html'], }) console.log(result.markdown_content) console.log(result.html_content) ``` ```bash cURL theme={null} curl -s -X POST "https://api.olostep.com/v1/scrapes" \ -H "Authorization: Bearer $OLOSTEP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url_to_scrape": "https://en.wikipedia.org/wiki/Alexander_the_Great", "formats": ["markdown", "html"] }' ``` ```bash CLI theme={null} olostep scrape "https://en.wikipedia.org/wiki/Alexander_the_Great" \ --formats markdown,html ``` ```js Node (API) theme={null} const endpoint = 'https://api.olostep.com/v1/scrapes' const payload = { url_to_scrape: 'https://en.wikipedia.org/wiki/Alexander_the_Great', formats: ['markdown', 'html'] } const res = await fetch(endpoint, { method: 'POST', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }) const data = await res.json() console.log(data) ``` ```python Python (API) theme={null} import requests import json endpoint = "https://api.olostep.com/v1/scrapes" payload = { "url_to_scrape": "https://en.wikipedia.org/wiki/Alexander_the_Great", "formats": ["markdown", "html"] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(endpoint, json=payload, headers=headers) print(json.dumps(response.json(), indent=2)) ``` ### Risposta L'API restituisce un oggetto `scrape` in risposta. Lo `scrape` ha alcune proprietà come `id` e `result`. L'oggetto `result` ha i seguenti campi (secondo il parametro `formats` alcuni potrebbero essere nulli): * `html_content`: il contenuto HTML della pagina. Passa `formats: ["html"]` per ottenere questo. * `markdown_content`: il contenuto MD della pagina. Passa `formats: ["markdown"]` per ottenere questo. * `text_content`: il contenuto testuale della pagina. Passa `formats: ["text"]` per ottenere questo. * `json_content`: il contenuto JSON della pagina. Passa `formats: ["json"]` per ottenere questo e fornisci anche un parametro `parser` o `llm_extract`. * `screenshot_hosted_url`: l'URL ospitato dello screenshot. * `html_hosted_url`: l'URL ospitato del contenuto HTML * `markdown_hosted_url`: l'URL ospitato del contenuto Markdown * `json_hosted_url`: l'URL ospitato del contenuto JSON * `text_hosted_url`: l'URL ospitato del contenuto testuale * `links_on_page`: i link sulla pagina * `page_metadata`: i metadati della pagina ```json theme={null} { "id": "scrape_6h89o8u1kt", "object": "scrape", "created": 1745673871, "metadata": {}, "retrieve_id": "6h89o8u1kt", "url_to_scrape": "https://en.wikipedia.org/wiki/Alexander_the_Great", "result": { "html_content": " ```python Python theme={null} from olostep import Olostep client = Olostep(api_key="YOUR_REAL_KEY") # Opt-in al caching: Accetta risultati fino a 1 giorno (86400 secondi) vecchi result = client.scrapes.create( url_to_scrape="https://example.com", formats=["markdown"], max_age=86400 ) ``` ```js Node theme={null} import Olostep from 'olostep' const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' }) // Opt-in al caching: Accetta risultati fino a 1 giorno (86400 secondi) vecchi const result = await client.scrapes.create({ url: 'https://example.com', formats: ['markdown'], maxAge: 86400, }) ``` ```bash cURL theme={null} # Opt-in al caching: Accetta risultati fino a 1 ora (3600 secondi) vecchi curl -X POST "https://api.olostep.com/v1/scrapes" \ -H "Authorization: Bearer $OLOSTEP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url_to_scrape": "https://example.com", "formats": ["markdown"], "max_age": 3600 }' ``` ```js Node (API) theme={null} const endpoint = 'https://api.olostep.com/v1/scrapes' const payload = { url_to_scrape: 'https://example.com', formats: ['markdown'], max_age: 86400 // Accetta risultati fino a 1 giorno (86400 secondi) vecchi } const res = await fetch(endpoint, { method: 'POST', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }) const data = await res.json() console.log(data) ``` ```python Python (API) theme={null} import requests import json endpoint = "https://api.olostep.com/v1/scrapes" payload = { "url_to_scrape": "https://example.com", "formats": ["markdown"], "max_age": 86400 # Accetta risultati fino a 1 giorno (86400 secondi) vecchi } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(endpoint, json=payload, headers=headers) print(json.dumps(response.json(), indent=2)) ``` ### Quando viene saltata la cache? La cache viene automaticamente bypassata (forzando uno scrape live) per funzionalità che richiedono sessioni uniche, output visivi in tempo reale o gestione di file personalizzati: * **Sessioni interattive:** Richieste che utilizzano `session_id` o caricano un `context` del browser personalizzato. * **Visuali:** Strumenti di visualizzazione e screenshot (`htmlVisualizer`). * **Tipi di file speciali:** Download di file binari o rendering di PDF grezzi. * **Debugging & Rete:** Cattura di `network_calls` o utilizzo di lavori di parser asincroni. ## Estrazione dei link Passa un oggetto `links_on_page` nella richiesta per raccogliere i link trovati sulla pagina. Tutti i link vengono restituiti come URL assoluti. ```json theme={null} "links_on_page": { "include_links": ["/blog/*"], "exclude_links": ["*.pdf"], "query_to_order_links_by": "pricing" } ``` * `include_links` / `exclude_links`: modelli glob abbinati al **path** dell'URL di ciascun link. * `query_to_order_links_by`: riordina i link restituiti in base alla rilevanza rispetto a questo testo. I modelli glob abbinano segmenti di percorso. Un singolo `*` non attraversa `/`, quindi `"/blog/*"` corrisponde a `"/blog/post-1"` ma **non** all'indice `"/blog"` stesso — e non corrisponde mai a `"/blog?tag=x"` perché le stringhe di query non fanno parte del percorso. Per includere anche l'indice, usa `"/blog*"` o `"{/blog,/blog/**}"`. ## Formati di Scrape Scegli uno o più formati di output tramite `formats`: * `markdown`: markdown adatto a LLM * `html`: HTML pulito * `text`: testo semplice * `json`: output strutturato (tramite parser o llm\_extract) * `raw_pdf`: byte di PDF grezzi estratti a URL ospitato * `screenshot`: impostato tramite azioni per catturare uno screenshot e restituire un URL ospitato Le chiavi di output vengono restituite all'interno di `result` come campi `*_content` e anche un `*_hosted_url`. ## Estrazione di dati strutturati Puoi estrarre JSON strutturato in due modi: usando i Parser o l'estrazione LLM. ### Utilizzando un Parser (consigliato per la scalabilità) Definisci `formats: ["json"]` e fornisci un `id` del parser. ```python Python theme={null} from olostep import Olostep client = Olostep(api_key="YOUR_REAL_KEY") result = client.scrapes.create( url_to_scrape="https://www.google.com/search?q=alexander+the+great&gl=us&hl=en", formats=["json"], parser="@olostep/google-search", ) print(result.json_content) ``` ```js Node theme={null} import Olostep from 'olostep' const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' }) const result = await client.scrapes.create({ url: 'https://www.google.com/search?q=alexander+the+great&gl=us&hl=en', formats: ['json'], parser: '@olostep/google-search', }) console.log(result.json_content) ``` ```bash cURL theme={null} curl -s -X POST "https://api.olostep.com/v1/scrapes" \ -H "Authorization: Bearer $OLOSTEP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url_to_scrape": "https://www.google.com/search?q=alexander+the+great&gl=us&hl=en", "formats": ["json"], "parser": {"id": "@olostep/google-search"} }' ``` ```bash CLI theme={null} olostep scrape "https://www.google.com/search?q=alexander+the+great&gl=us&hl=en" \ --formats json \ --payload-json '{"parser":{"id":"@olostep/google-search"}}' ``` ```js Node (API) theme={null} const res = await fetch('https://api.olostep.com/v1/scrapes', { method: 'POST', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, body: JSON.stringify({ url_to_scrape: 'https://www.google.com/search?q=alexander+the+great&gl=us&hl=en', formats: ['json'], parser: { id: '@olostep/google-search' } }) }) console.log(await res.json()) ``` ```python Python (API) theme={null} import requests, json endpoint = "https://api.olostep.com/v1/scrapes" payload = { "url_to_scrape": "https://www.google.com/search?q=alexander+the+great&gl=us&hl=en", "formats": ["json"], "parser": { "id": "@olostep/google-search" } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } res = requests.post(endpoint, json=payload, headers=headers) print(json.dumps(res.json(), indent=2)) ``` Olostep ha alcuni parser pre-costruiti per [siti web popolari](https://www.olostep.com/store) ma puoi anche creare i tuoi parser tramite il dashboard o chiedere al nostro team di farlo per te. I parser sono auto-riparanti e si aggiorneranno all'ultima versione del sito web. ### Utilizzando l'estrazione LLM (schema e/o prompt) Fornisci `llm_extract` con uno Schema JSON (`schema`) e/o un'istruzione in linguaggio naturale (`prompt`). Puoi passare entrambi i parametri, ma se entrambi sono forniti, `schema` ha la precedenza. In alternativa, se passi solo un `prompt`, l'LLM estrarrà i dati in base al prompt e deciderà autonomamente la struttura dei dati. ```python Python theme={null} from olostep import LLMExtract, Olostep client = Olostep(api_key="YOUR_REAL_KEY") result = client.scrapes.create( url_to_scrape="https://www.berklee.edu/events/stefano-marchese-friends", formats=["markdown", "json"], llm_extract=LLMExtract( schema={ "event": { "type": "object", "properties": { "title": {"type": "string"}, "date": {"type": "string"}, "description": {"type": "string"}, "venue": {"type": "string"}, "address": {"type": "string"}, "start_time": {"type": "string"}, }, } } ), ) print(result.json_content) ``` ```js Node theme={null} import Olostep from 'olostep' const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' }) const result = await client.scrapes.create({ url: 'https://www.berklee.edu/events/stefano-marchese-friends', formats: ['markdown', 'json'], llmExtract: { schema: { event: { type: 'object', properties: { title: { type: 'string' }, date: { type: 'string' }, description: { type: 'string' }, venue: { type: 'string' }, address: { type: 'string' }, start_time: { type: 'string' }, }, }, }, }, }) console.log(result.json_content) ``` ```bash cURL theme={null} curl -s -X POST "https://api.olostep.com/v1/scrapes" \ -H "Authorization: Bearer $OLOSTEP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url_to_scrape": "https://www.berklee.edu/events/stefano-marchese-friends", "formats": ["json"], "llm_extract": { "prompt": "Extract the event title, date, description, venue, address, and start time from the page." } }' ``` ```bash CLI theme={null} olostep scrape "https://www.berklee.edu/events/stefano-marchese-friends" \ --formats json \ --payload-json '{"llm_extract":{"prompt":"Extract the event title, date, description, venue, address, and start time from the page."}}' ``` ```js Node (API) theme={null} const res = await fetch('https://api.olostep.com/v1/scrapes', { method: 'POST', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, body: JSON.stringify({ url_to_scrape: 'https://www.berklee.edu/events/stefano-marchese-friends', formats: ['json'], llm_extract: { prompt: 'Extract the event title, date, description, venue, address, and start time from the page.' } }) }) console.log(await res.json()) ``` ```python Python (API) theme={null} import requests, json endpoint = "https://api.olostep.com/v1/scrapes" payload = { "url_to_scrape": "https://www.berklee.edu/events/stefano-marchese-friends", "formats": ["markdown", "json"], "llm_extract": { "schema": { "event": { "type": "object", "properties": { "title": {"type": "string"}, "date": {"type": "string"}, "description": {"type": "string"}, "venue": {"type": "string"}, "address": {"type": "string"}, "start_time": {"type": "string"} } } } } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } res = requests.post(endpoint, json=payload, headers=headers) print(json.dumps(res.json(), indent=2)) ``` Nota: `result.json_content` restituisce un JSON stringificato. Analizzalo nel tuo codice se hai bisogno di un oggetto. **Prezzi:** `llm_extract` costa 10 crediti per scrape. Per ridurre il costo, puoi portare le tue chiavi API o abilitare la tariffazione basata sull'uso. Contatta [info@olostep.com](mailto:info@olostep.com) per ottenere l'accesso. ## Estrai link sulla pagina Con l'opzione `links_on_page`, puoi estrarre tutti i link presenti sulla pagina che fai scraping. Accetta i seguenti parametri per aiutare a filtrare e ordinare i link estratti: * `absolute_links` (booleano, predefinito: `true`): Quando è vero, restituisce URL completi (es. `https://example.com/page`) invece di percorsi relativi (es. `/page`). * `query_to_order_links_by` (stringa): Ordina i link restituiti in base alla loro somiglianza con il testo della query fornita, dando priorità alle corrispondenze più rilevanti. * `include_links` (array di stringhe): Filtra i link estratti utilizzando modelli glob. Usa modelli come `*.pdf` per abbinare estensioni di file, `/blog/*` per percorsi specifici, o URL completi come `https://example.com/*`. Supporta caratteri jolly (`*`), classi di caratteri (`[a-z]`), e alternanza (`{pattern1,pattern2}`). * `exclude_links` (array di stringhe): Escludi link specifici utilizzando modelli glob, seguendo la stessa sintassi di `include_links`. ## Interagire con la pagina con Azioni Esegui azioni prima di fare scraping per interagire con siti dinamici. Azioni supportate: * `wait` con `milliseconds` * `click` con `selector` * `fill_input` con `selector` e `value` * `scroll` con `direction` e `amount` È spesso utile usare `wait` prima/dopo altre azioni per permettere il caricamento della pagina. ### Esempio ```python Python theme={null} from olostep import FillInputAction, Olostep, WaitAction client = Olostep(api_key="YOUR_REAL_KEY") result = client.scrapes.create( url_to_scrape="https://example.com/login", formats=["markdown"], actions=[ FillInputAction(selector="input[type=email]", value="john@example.com"), WaitAction(milliseconds=500), FillInputAction(selector="input[type=password]", value="secret"), {"type": "click", "selector": "button[type=\"submit\"]"}, WaitAction(milliseconds=1500), ], ) print(result.markdown_content) ``` ```js Node theme={null} import Olostep from 'olostep' const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' }) const result = await client.scrapes.create({ url: 'https://example.com/login', formats: ['markdown'], actions: [ { type: 'fill_input', selector: 'input[type=email]', value: 'john@example.com' }, { type: 'wait', milliseconds: 500 }, { type: 'fill_input', selector: 'input[type=password]', value: 'secret' }, { type: 'click', selector: 'button[type="submit"]' }, { type: 'wait', milliseconds: 1500 }, ], }) console.log(result.markdown_content) ``` ```bash cURL theme={null} curl -s -X POST "https://api.olostep.com/v1/scrapes" \ -H "Authorization: Bearer $OLOSTEP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url_to_scrape": "https://example.com/login", "formats": ["markdown"], "actions": [ { "type": "fill_input", "selector": "input[type=email]", "value": "john@example.com" }, { "type": "wait", "milliseconds": 500 }, { "type": "fill_input", "selector": "input[type=password]", "value": "secret" }, { "type": "click", "selector": "button[type=\"submit\"]" }, { "type": "wait", "milliseconds": 1500 } ] }' ``` ```bash CLI theme={null} # Per opzioni complesse come le azioni, usa --payload-file con un file JSON olostep scrape "https://example.com/login" \ --formats markdown \ --payload-file actions.json # Dove actions.json contiene: # { # "actions": [ # {"type": "fill_input", "selector": "input[type=email]", "value": "john@example.com"}, # {"type": "wait", "milliseconds": 500}, # {"type": "fill_input", "selector": "input[type=password]", "value": "secret"}, # {"type": "click", "selector": "button[type=\"submit\"]"}, # {"type": "wait", "milliseconds": 1500} # ] # } ``` ```js Node (API) theme={null} const res = await fetch('https://api.olostep.com/v1/scrapes', { method: 'POST', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, body: JSON.stringify({ url_to_scrape: 'https://example.com/login', formats: ['markdown'], actions: [ { type: 'fill_input', selector: 'input[type=email]', value: 'john@example.com' }, { type: 'wait', milliseconds: 500 }, { type: 'fill_input', selector: 'input[type=password]', value: 'secret' }, { type: 'click', selector: 'button[type="submit"]' }, { type: 'wait', milliseconds: 1500 } ] }) }) console.log(await res.json()) ``` ```python Python (API) theme={null} import requests, json endpoint = "https://api.olostep.com/v1/scrapes" payload = { "url_to_scrape": "https://example.com/login", "formats": ["markdown"], "actions": [ {"type": "fill_input", "selector": "input[type=email]", "value": "john@example.com"}, {"type": "wait", "milliseconds": 500}, {"type": "fill_input", "selector": "input[type=password]", "value": "secret"}, {"type": "click", "selector": "button[type=\"submit\"]"}, {"type": "wait", "milliseconds": 1500} ] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } res = requests.post(endpoint, json=payload, headers=headers) print(json.dumps(res.json(), indent=2)) ``` La risposta includerà qualsiasi formato richiesto (es. `markdown_content`). ## Casi d'Uso Di seguito sono riportate alcune applicazioni pratiche dei clienti che utilizzano l'endpoint `/scrapes`. ### Analisi dei Contenuti e Ricerca * **Analisi Competitiva**: Estrai dettagli sui prodotti, prezzi e caratteristiche dai siti web dei concorrenti * **Ricerca di Mercato**: Analizza pagine di destinazione, descrizioni dei prodotti e testimonianze dei clienti * **Ricerca Accademica**: Raccogli dati specifici da pubblicazioni scientifiche o portali di ricerca * **Documentazione Legale**: Estrai studi di casi, regolamenti o precedenti legali da siti ufficiali ### E-commerce e Retail * **Strategie di Prezzi Dinamici**: Ottieni prezzi dei prodotti in tempo reale dai negozi concorrenti * **Gestione delle Informazioni sui Prodotti**: Estrai specifiche dettagliate e descrizioni * **Monitoraggio Stock/Inventario**: Controlla la disponibilità dei prodotti presso altri rivenditori * **Analisi delle Recensioni**: Raccogli feedback dei consumatori e sentiment per prodotti specifici ### Marketing e Creazione di Contenuti * **Curazione di Contenuti**: Estrai articoli e post di blog rilevanti per newsletter * **Analisi SEO**: Esamina l'uso delle parole chiave dei concorrenti, meta descrizioni e struttura delle pagine * **Generazione di Lead**: Estrai informazioni di contatto da directory aziendali o pagine aziendali * **Ricerca di Influencer**: Raccogli metriche di coinvolgimento e stili di contenuto dai profili degli influencer * **Generazione di Social Media Personalizzati**: Crea marketing sui social media alimentato da AI analizzando i siti web dei clienti ### Applicazioni di Dati * **Raccolta di Dati di Addestramento AI**: Raccogli esempi specifici per modelli di machine learning * **Costruzione di Basi di Conoscenza Personalizzate**: Estrai documentazione o istruzioni da siti software * **Archivi di Dati Storici**: Conserva il contenuto del sito web in momenti specifici nel tempo * **Estrazione di Dati Strutturati**: Trasforma il contenuto web in dataset formattati per l'analisi ### Monitoraggio e Avvisi * **Monitoraggio della Conformità Regolamentare**: Tieni traccia delle modifiche ai siti web legali o regolamentari * **Gestione delle Crisi**: Monitora i siti di notizie per menzioni di eventi o organizzazioni specifiche * **Tracciamento degli Eventi**: Estrai dettagli sugli eventi imminenti dai siti di sedi o organizzatori * **Monitoraggio dello Stato del Servizio**: Controlla le pagine di stato del servizio per piattaforme o strumenti specifici ### Pubblicazione e Media * **Aggregazione di Notizie**: Estrai notizie dell'ultima ora da fonti ufficiali * **Monitoraggio dei Media**: Tieni traccia di argomenti specifici sui siti di notizie * **Verifica dei Contenuti**: Estrai informazioni per verificare affermazioni o dichiarazioni * **Estrazione Multimediale**: Raccogli video, immagini o audio incorporati per librerie multimediali ### Applicazioni Finanziarie * **Ricerca sugli Investimenti**: Estrai bilanci o relazioni annuali dai siti web delle aziende * **Indicatori Economici**: Raccogli dati economici da siti web governativi o istituzioni finanziarie * **Dati sulle Criptovalute**: Estrai informazioni sui prezzi in tempo reale e sulla capitalizzazione di mercato * **Analisi delle Notizie Finanziarie**: Monitora i siti di notizie finanziarie per segnali di mercato specifici ### Applicazioni Tecniche * **Estrazione di Documentazione API**: Raccogli documentazione tecnica per riferimento * **Test di Integrazione**: Estrai elementi del sito web per verificare integrazioni di terze parti * **Test di Accessibilità**: Analizza la struttura del sito web per la conformità agli standard di accessibilità * **Creazione di Archivi Web**: Cattura il contenuto completo del sito web per la conservazione storica ### Scenari di Integrazione * **Sistemi CRM**: Migliora i profili dei clienti con dati dai siti web aziendali o Linkedin * **Sistemi di Gestione dei Contenuti**: Importa contenuti esterni rilevanti * **Strumenti di Business Intelligence**: Integra dati interni con informazioni di mercato esterne * **Software di Gestione Progetti**: Estrai specifiche o requisiti dai siti web dei clienti * **Dashboard Personalizzati**: Visualizza i dati estratti accanto a metriche interne ## Gestione degli Errori Tutti gli errori seguono una forma di busta condivisa. Controlla `error.type` e `error.code` per ramificare programmaticamente: ```json theme={null} { "id": "error_abc123", "object": "error", "created": 1745673871, "url": "https://example.com", "metadata": {}, "error": { "type": "...", "code": "...", "message": "..." } } ``` | HTTP | `error.type` | `error.code` | Significato | | ---- | ----------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------- | | 400 | `invalid_request_error` | `dns_resolution_failed` | Il dominio non esiste o l'URL contiene un errore di battitura. | | 400 | `invalid_request_error` | `invalid_url` | L'URL è malformato. | | 502 | `invalid_request_error` | `tls_error` | Il sito web ha un certificato TLS/SSL non valido o incompatibile. `error.detail` contiene il codice SSL di basso livello. | | 504 | `request_timeout` | `scrape_poll_timeout` | Lo scrape non è stato completato entro il tempo di attesa di \~55 secondi. | ### Errore DNS (400) Il dominio non si risolve. Controlla l'URL per errori di battitura. ```json theme={null} { "error": { "type": "invalid_request_error", "code": "dns_resolution_failed", "message": "L'URL contiene un errore di battitura, o il dominio non esiste." } } ``` ### Errore TLS/SSL (502) Il sito web di destinazione ha una configurazione HTTPS rotta o incompatibile. `error.detail` fornisce il codice di errore SSL specifico per la diagnostica; `error.code` è sempre `tls_error`. ```json theme={null} { "error": { "type": "invalid_request_error", "code": "tls_error", "detail": "err_ssl_tlsv1_alert_internal_error", "message": "Il sito web ha chiuso o rifiutato la stretta di mano TLS. Il server potrebbe essere configurato in modo errato o utilizzare una versione SSL/TLS non supportata." } } ``` ### Timeout della Richiesta (504) Lo scrape non è stato completato entro il tempo di attesa. La pagina potrebbe essere lenta, protetta da bot o temporaneamente non disponibile. Questa risposta è sicura da riprovare. ```json theme={null} { "error": { "type": "request_timeout", "code": "scrape_poll_timeout", "message": "Richiesta scaduta mentre si attendeva il risultato dello scrape. La pagina potrebbe essere lenta, bloccata per i nostri fetcher, o temporaneamente non disponibile." } } ``` ## Prezzi Lo scrape costa 1 credito di default. Se passi anche [parser](/features/structured-content/parsers), i costi variano per parser (1-5 crediti). Se usi [estrazione LLM](/features/structured-content/llm-extraction), costa 10 crediti.