> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Retrieval

> Trova fonti aggiornate con Venice Web Search ed estrai le pagine selezionate come Markdown con Venice Web Scrape.

Venice fornisce API separate per scoprire pagine web ed estrarne il contenuto:

* **Web Search** restituisce risultati strutturati con titoli, URL, snippet e date.
* **Web Scrape** converte una pagina pubblica selezionata in Markdown.

Usale insieme quando la tua applicazione ha bisogno di materiale sorgente aggiornato e ispezionabile prima dell'inferenza.

## Cercare sul web

Invia una query all'API Search:

```bash theme={"system"}
curl https://api.venice.ai/api/v1/augment/search \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latest developments in decentralized AI"}'
```

Brave è il provider predefinito e offre Zero Data Retention. È disponibile anche Google con query anonimizzate instradate tramite Venice. Consulta il [riferimento API Web Search](/api-reference/endpoint/augment/search) per la selezione del provider e lo schema di risposta completo.

## Estrarre una pagina

Dopo aver selezionato un risultato, invia il suo URL pubblico all'API Scrape:

```bash theme={"system"}
curl https://api.venice.ai/api/v1/augment/scrape \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/article"}'
```

L'endpoint restituisce il contenuto della pagina in Markdown. Innanzitutto richiede la rappresentazione Markdown nativa del sito quando disponibile e altrimenti utilizza un'estrazione basata su browser.

## Flusso search-to-scrape

<Steps>
  <Step title="Cerca">
    Invia una query mirata e raccogli i risultati strutturati.
  </Step>

  <Step title="Seleziona le fonti">
    Filtra i risultati per rilevanza, dominio e data prima di recuperare il contenuto delle pagine.
  </Step>

  <Step title="Estrai">
    Estrai il Markdown solo dalle pagine che la tua applicazione intende utilizzare.
  </Step>

  <Step title="Usa o memorizza il contenuto">
    Includi il Markdown in un prompt, crea embedding, mettilo in cache, oppure conserva gli URL sorgente per le citazioni.
  </Step>
</Steps>

## API standalone o web search del modello?

Usa le API standalone quando la tua applicazione ha bisogno di controllo sulla selezione delle fonti o vuole riutilizzare il contenuto recuperato. Abilita la web search su una richiesta al modello quando desideri che Venice gestisca il retrieval come parte di un'unica richiesta di inferenza.

| Esigenza                                                                | Approccio              |
| ----------------------------------------------------------------------- | ---------------------- |
| Ispezionare o filtrare i risultati prima dell'inferenza                 | Web Search standalone  |
| Estrarre un URL specifico noto                                          | Web Scrape standalone  |
| Mettere in cache o riutilizzare il contenuto recuperato                 | API standalone         |
| Lasciare che il modello recuperi automaticamente il contesto aggiornato | Web search del modello |

<Warning>
  Web Search e Web Scrape sono API sperimentali. I loro formati di richiesta e risposta possono cambiare senza preavviso. Web Scrape accetta solo pagine accessibili pubblicamente, e i siti che bloccano l'accesso automatizzato possono essere rifiutati.
</Warning>

## Risorse correlate

* [Riferimento API Web Search](/api-reference/endpoint/augment/search)
* [Riferimento API Web Scrape](/api-reference/endpoint/augment/scrape)
* [Agente di ricerca privato](/guides/projects/private-research-agent)
* [Embeddings](/guides/features/embeddings)