Skip to main content

Panoramica

L’API di Olostep ti permette di estrarre dati strutturati dai risultati dei motori di ricerca utilizzando i parser. Questi parser trasformano l’HTML grezzo dei risultati di ricerca in dati JSON puliti e strutturati, pronti per l’analisi o l’integrazione nelle tue applicazioni.

Esempio di Integrazione

Per ottenere contenuti JSON analizzati dai risultati di ricerca, devi includere json nel parametro formats e specificare il nome del parser @olostep/google-search nell’oggetto parser. Ecco come recuperare i risultati di ricerca di Google in un formato strutturato:

Formato della Risposta

Quando fai una richiesta all’API di Olostep con il parser Google Search, riceverai una risposta JSON come l’esempio qui sotto:
La risposta contiene:
  • Informazioni di base sulla richiesta: id, object, timestamp created, url_to_scrape
  • Oggetto result con URL per accedere a diversi formati dei dati
  • json_content con risultati di ricerca strutturati che includono:
  • searchParameters: Informazioni sulla query di ricerca
  • knowledgeGraph: Informazioni dettagliate sul soggetto della ricerca (quando disponibili)
  • organic: Elenco dei risultati di ricerca con titolo, link, posizione e snippet
  • peopleAlsoAsk: Domande correlate che gli utenti cercano comunemente
  • relatedSearches: Suggerimenti di ricerche correlate
json_content è la parte principale della risposta con i risultati di ricerca strutturati. Puoi accedere al contenuto JSON direttamente dalla risposta o utilizzare l’URL ospitato fornito nella risposta.

Risposta Strutturata: json_content

Olostep fornisce anche un file JSON ospitato con i risultati di ricerca strutturati. Puoi accedere al file JSON utilizzando il campo json_hosted_url nella risposta: Se vuoi ottenere anche il contenuto HTML e Markdown dei risultati di ricerca, puoi includere questi formati nel parametro formats e Olostep li restituirà nella risposta e fornirà URL ospitati per ciascun formato.

Note Importanti

Parametri di Ricerca: I parametri gl=us e hl=en impostano la geolocalizzazione su US e la lingua su Inglese. Modificali secondo necessità.

Conclusione

Passare parser personalizzati all’API ti permette di ottenere solo i dati strutturati che desideri. Questo rende facile integrare i risultati di ricerca nelle tue applicazioni, eseguire analisi dei dati o costruire funzionalità correlate alla ricerca. Per ottenere informazioni sui parser disponibili o per richiedere un parser personalizzato per il tuo caso d’uso specifico, contattaci a info@olostep.com.