Zum Hauptinhalt springen
Der Olostep-Endpunkt /v1/searches ermöglicht es dir, das Web mit einer natürlichen Sprachabfrage zu durchsuchen und eine deduplizierte Liste relevanter Links mit Titeln und Beschreibungen zurückzubekommen.
  • Sende eine Abfrage in einfachem Englisch
  • Erhalte strukturierte Links aus dem gesamten Web zurück
Es wird die Abfrage semantisch im gesamten Web durchsuchen und Ergebnisse zurückgeben. Für API-Details, siehe die Such-Endpunkt-API-Referenz.

​
Installation

# pip install requests

import requests

​
Verwendung

Sende eine Abfrage in natürlicher Sprache und erhalte eine Liste relevanter Links. 
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))

​
Antwort

Du erhältst ein search-Objekt als Antwort. Das search-Objekt enthält eine id, deine ursprüngliche query und ein result mit einer Liste von 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..."
      }
    ]
  }
}
Jeder Link in result.links enthält:
FeldTypBeschreibung
urlstringDie URL des Suchergebnisses
titlestringDer Titel der Ergebnisseite
descriptionstringEin kurzer Ausschnitt, der das Ergebnis beschreibt
Das vollständige Ergebnis ist auch als gehostete JSON-Datei unter result.json_hosted_url verfügbar.

​
Preisgestaltung

Die Suche kostet 5 Credits pro Anfrage.