Vai al contenuto principale
L’endpoint Olostep /v1/searches ti consente di cercare sul web con una query in linguaggio naturale e ottenere un elenco deduplicato di link rilevanti con titoli e descrizioni.
  • Invia una query in inglese semplice
  • Ricevi link strutturati da tutto il web
Effettuerà una ricerca semantica della query sul web e restituirà i risultati. Per i dettagli dell’API, consulta la Riferimento API dell’Endpoint di Ricerca.

​
Installazione

# pip install requests

import requests

​
Utilizzo

Invia una query in linguaggio naturale e ricevi un elenco di link rilevanti. 
import requests, json

endpoint = "https://api.olostep.com/v1/searches"
payload = {
  "query": "Best Answer Engine Optimization startups"
}
headers = {"Authorization": "Bearer <YOUR_API_KEY>", "Content-Type": "application/json"}

response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

​
Risposta

Riceverai un oggetto search in risposta. L’oggetto search contiene un id, la tua query originale e un result con un elenco di links. 
{
  "id": "search_9bi0sbj9xa",
  "object": "search",
  "created": 1760327323,
  "metadata": {},
  "query": "Best Answer Engine Optimization startups",
  "result": {
    "json_content": "...",
    "json_hosted_url": "https://olostep-storage.s3.us-east-1.amazonaws.com/search_9bi0sbj9xa.json",
    "links": [
      {
        "url": "https://www.adweek.com/media/hottest-startups-shaping-the-future-of-ai-search-optimization-aeo-geo/",
        "title": "Meet the 7 Hottest Startups Shaping the Future of AI SEO",
        "description": "1. Profound · 2. Bluefish · 3. Scrunch · 4. Evertune · 5. Peec AI · 6. Brandlight · 7. AthenaHQ."
      },
      {
        "url": "https://www.failory.com/startups/search-engine",
        "title": "Top 48 Search Engine Startups to Watch in 2026",
        "description": "A deep dive into the 48 most promising search engine startups..."
      },
      {
        "url": "https://clutch.co/seo-firms/startups",
        "title": "Top 30 SEO Companies for Startups - Mar 2026 Rankings",
        "description": "Connect with the best SEO companies..."
      }
    ]
  }
}
Ogni link in result.links contiene:
CampoTipoDescrizione
urlstringL’URL del risultato della ricerca
titlestringIl titolo della pagina del risultato
descriptionstringUn breve frammento che descrive il risultato
Il risultato completo è anche disponibile come file JSON ospitato su result.json_hosted_url.

​
Prezzi

La ricerca costa 5 crediti per richiesta.