Saltar al contenido principal
El endpoint de Olostep /v1/searches te permite buscar en la web con una consulta en lenguaje natural y obtener una lista deduplicada de enlaces relevantes con títulos y descripciones.
  • Envía una consulta en inglés simple
  • Recibe enlaces estructurados de toda la web
Buscará la consulta semánticamente en toda la web y devolverá resultados. Para detalles de la API, consulta la Referencia de la API del Endpoint de Búsqueda.

Instalación

# pip install requests

import requests

Uso

Envía una consulta en lenguaje natural y recibe una lista de enlaces relevantes.
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))

Respuesta

Recibirás un objeto search en respuesta. El objeto search contiene un id, tu query original, y un result con una lista de 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..."
      }
    ]
  }
}
Cada enlace en result.links contiene:
CampoTipoDescripción
urlstringLa URL del resultado de búsqueda
titlestringEl título de la página de resultados
descriptionstringUn breve fragmento que describe el resultado
El resultado completo también está disponible como un archivo JSON alojado en result.json_hosted_url.

Precios

La búsqueda cuesta 5 créditos por solicitud.