Olostep Search-Endpoint
Verwandle eine Frage in eingestufte Web-Links.
Das Vertrauen von Teams weltweit
Von der Anfrage zur Link-Liste
Discovery-API — kombiniere sie mit Scrapes oder Batches, wenn du den Seiteninhalt benötigst.
Step 1
Sende deine Anfrage
Sende (POST) ein JSON mit query — in normaler Sprache, keine URL-Liste erforderlich.
Step 2
Erhalte Links
Erhalte ein search-Objekt mit result.links: url, title, description (dedupliziert).
Step 3
Erneut per id abrufen
Speichere die id aus der Antwort; rufe GET /v1/searches/{search_id} auf, um dasselbe Ergebnis später erneut zu laden.
POST /v1/searches
{
"query": "Latest updates with Apple"
}Für Discovery entwickelt
Semantische Suche über das gesamte Web, strukturiert für Agenten und Dashboards.
Semantische Suche
Erweitert deine Anfrage zu gezieltem Retrieval über das gesamte Web — nicht nur Keyword-Matching auf einer einzelnen Domain.
Strukturierte Links
Jeder Eintrag enthält url, title und description, damit UIs und Agenten schnell einstufen und filtern können.
Gehostetes JSON
Vollständige Payloads können json_hosted_url enthalten, um bei Bedarf das komplette Ergebnis-Set herunterzuladen.
5 Credits pro Suche
Vorhersehbare Kosten pro Anfrage — kombiniere mit Scrapes oder Batches nur für die URLs, die du wirklich brauchst.
Was du damit bauen kannst
Nutze Search, wenn eine SERP-artige Link-Liste besser ist, als das HTML einer Suchmaschine selbst zu scrapen.
Recherche & Copiloten
Zeige Kandidatenquellen auf, bevor du tiefer liest oder scrapst.
Leads & Marktentdeckung
Verwandle eine Frage in eine Shortlist von Unternehmen, Artikeln oder Produktseiten.
Pipeline-Eingangstür
Search → Filtern → URLs in Batch-Jobs oder /v1/scrapes einreihen.
Web-Search-API
Eine Anfrage. Deduplizierte Links.
Optionales json_hosted_url für die vollständige Payload. Erneut abrufen mit GET /v1/searches/{search_id}.
{
"query": "Latest updates with Apple"
}{
"id": "search_9bi0sbj9xa",
"object": "search",
"created": 1760327323,
"query": "Latest updates with Apple",
"result": {
"links": [
{
"url": "https://www.adweek.com/media/…",
"title": "Meet the 7 Hottest Startups…",
"description": "1. Profound · 2. Bluefish · …"
}
],
"json_hosted_url": "https://olostep-storage.s3.us-east-1.amazonaws.com/search_9bi0sbj9xa.json"
}
}Häufig gestellte Fragen
Produkt & Funktionen
- Wie unterscheidet sich der Search-Endpoint von Answers?
Search liefert eine deduplizierte Liste relevanter Links (url, title, description) für deine Anfrage — ideal, wenn du Kandidaten zum Einstufen, Filtern oder selbst Scrapen möchtest. Answers führt einen tieferen agentischen Ablauf aus, um eine einzelne Antwort und optional strukturiertes JSON mit Quellenvalidierung zu synthetisieren.
- Wie unterscheidet sich Search von Map?
Map entdeckt URLs für eine von dir angegebene Domain (Sitemaps + Links auf dieser Website). Search führt eine semantische Anfrage über das gesamte Web aus und liefert thematisch relevante Seiten von vielen Domains.
Nutzung & Automatisierung
- Wann sollte ich Search mit Scrapes oder Batches verketten?
Nutze Search, um URLs vorzuschlagen, und übergib dann ausgewählte URLs an POST /v1/scrapes für den vollständigen Seiteninhalt oder an einen Batch-Job bei einer großen Liste. Search liefert Discovery; Scrapes/Batches liefern Extraktion im großen Maßstab.
- Was enthält eine search-Antwort?
Ein search-Objekt mit id, query und result.links. Jeder Link hat url, title und description. Die vollständige Payload kann außerdem json_content und json_hosted_url für das komplette strukturierte Ergebnis gemäß API-Referenz enthalten.
Preise & Tarife
- Kann ich eine Suche später erneut abrufen?
Ja. Behalte nach POST /v1/searches die zurückgegebene id und rufe GET /v1/searches/{search_id} auf, um dasselbe search-Objekt erneut abzurufen.
- Was kostet Search?
Search kostet laut Olostep-Preisdokumentation 5 Credits pro Anfrage. Prüfe dein Dashboard für aktuelle Guthaben und Pläne.
Teste die semantische Websuche
500 kostenlose Credits zum Testen
Keine Kreditkarte erforderlich.