Passer au contenu principal
Le point de terminaison /v1/searches d’Olostep te permet de rechercher sur le web avec une requête en langage naturel et d’obtenir une liste dédupliquée de liens pertinents avec des titres et des descriptions.
  • Envoie une requête en anglais simple
  • Reçois des liens structurés de tout le web
Il recherchera la requête de manière sémantique sur le web et renverra les résultats. Pour les détails de l’API, consulte la Référence de l’API du point de terminaison de recherche.

​
Installation

# pip install requests

import requests

​
Utilisation

Envoie une requête en langage naturel et reçois une liste de liens pertinents. 
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))

​
Réponse

Tu recevras un objet search en réponse. L’objet search contient un id, ta query originale, et un result avec une liste 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..."
      }
    ]
  }
}
Chaque lien dans result.links contient :
ChampTypeDescription
urlstringL’URL du résultat de recherche
titlestringLe titre de la page de résultat
descriptionstringUn court extrait décrivant le résultat
Le résultat complet est également disponible sous forme de fichier JSON hébergé à result.json_hosted_url.

​
Tarification

La recherche coûte 5 crédits par requête.