Guida rapida

Ottieni i primi risultati di ricerca in meno di 2 minuti.

1. Ottieni la tua chiave API

Iscriviti al Scavio Dashboard e crea una chiave API dalla pagina Chiavi API. La tua chiave inizierà con sk_live_ o sk_test_.

2. Effettua la tua prima richiesta

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"query": "Scavio search API"}'

3. Leggi la risposta

Una risposta di successo restituisce un oggetto JSON con un array results . Ogni risultato include un title, url, e content.

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform...",
      "position": 1
    }
  ],
  "query": "Scavio search API",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

4. Prova i parametri avanzati

Aggiungi parametri opzionali per personalizzare la ricerca. Questo esempio cerca notizie negli Stati Uniti:

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "AI startups funding",
    "search_type": "news",
    "country_code": "us",
    "language": "en"
  }'

5. Usa l'SDK Python

L'SDK Python ufficiale fornisce un client tipizzato con supporto sincrono e asincrono, limitazione della velocità integrata e accesso a tutte le 6 fonti dati.

pip install scavio

6. Usa con LangChain

Installa langchain-scavio per utilizzare Scavio come strumenti LangChain nei tuoi agenti. Supporta Google, Amazon, Walmart e YouTube.

pip install langchain-scavio

Prossimi passi

• Google Search API -- reference completa dell'endpoint con formato della risposta
• API YouTube -- ricerca e metadati
• API Amazon -- ricerca e dettagli prodotti
• API Walmart -- ricerca e dettagli prodotti
• Codici paese -- reference dei codici paese supportati