curl --request POST \
--url https://api.olostep.com/v1/searches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Best Answer Engine Optimization startups"
}
'{
"storage": {
"expires_in": "7d"
},
"id": "search_9bi0sbj9xa",
"object": "search",
"created": 1760327323,
"metadata": {},
"query": "Best Answer Engine Optimization startups",
"credits_consumed": 10,
"result": {
"json_content": "<string>",
"json_hosted_url": "<string>",
"links": [
{
"url": "<string>",
"title": "<string>",
"description": "<string>",
"markdown_content": "<string>",
"html_content": "<string>"
}
],
"size_exceeded": true,
"credits_consumed": 123
}
}Suche erstellen
Durchsuche das Web mit einer Abfrage in natürlicher Sprache und erhalte eine deduplizierte Liste relevanter Links mit Titeln und Beschreibungen. Die Abfrage wird semantisch im gesamten Web durchsucht und Ergebnisse werden zurückgegeben. Optional kannst du scrape_options übergeben, um jede zurückgegebene URL ebenfalls zu scrapen und markdown_content / html_content direkt in jeden Link einzubetten. Seiten-Scrapes werden automatisch über den zugrunde liegenden /v1/scrapes-Endpunkt gegen dein Team abgerechnet. Siehe Suchfunktion.
curl --request POST \
--url https://api.olostep.com/v1/searches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Best Answer Engine Optimization startups"
}
'{
"storage": {
"expires_in": "7d"
},
"id": "search_9bi0sbj9xa",
"object": "search",
"created": 1760327323,
"metadata": {},
"query": "Best Answer Engine Optimization startups",
"credits_consumed": 10,
"result": {
"json_content": "<string>",
"json_hosted_url": "<string>",
"links": [
{
"url": "<string>",
"title": "<string>",
"description": "<string>",
"markdown_content": "<string>",
"html_content": "<string>"
}
],
"size_exceeded": true,
"credits_consumed": 123
}
}storage.expires_in, um die gespeicherten Dateien dieser Suche länger als die standardmäßigen 7 Tage aufzubewahren. Werte: 7d, 10d, 30d, 60d, 90d, 180d, 365d oder never. Siehe Speicherung für Details.Autorisierungen
Bearer-Authentifizierungs-Header in der Form Bearer , wobei dein Authentifizierungs-Token ist.
Body
Die Suchabfrage in natürlicher Sprache.
"What's going on with OpenAI's Sora shutting down?"
Bestimmt, wie lange die gespeicherten Dateien dieser Suche (ihre Datei und jeglicher gescrapeter Linkinhalt) aufbewahrt werden. Wenn weggelassen, werden sie 7 Tage lang aufbewahrt. Der wirksame Wert wird in der Antwort als storage.expires_in zurückgegeben. Siehe den Abschnitt Speicher in den Funktionsdokumenten. Ein ungültiger Wert gibt 400 mit dem Code invalid_storage_expires_in zurück.
Show child attributes
Show child attributes
Maximale Anzahl von Links, die nach der Deduplizierung zurückgegeben werden sollen.
1 <= x <= 2510
Beschränke die Ergebnisse auf diese Domains. Nur nackte Hosts — führendes http(s):// und abschließende Schrägstriche werden automatisch entfernt.
["nytimes.com", "wsj.com"]
Schließe Ergebnisse von diesen Domains aus. Nur nackte Hosts — führendes http(s):// und abschließende Schrägstriche werden automatisch entfernt.
["reddit.com"]
Fordere eine direkte, latenzarme Suche mit deiner Abfrage wortwörtlich an. Der Standardmodus führt eine breitere Suche für eine größere Ergebnisabdeckung durch.
Optional. Wenn angegeben, wird jeder zurückgegebene Link auch gescraped und sein Inhalt in die Antwort eingebettet. Pro-Seite-Scrape-Credits werden automatisch vom zugrunde liegenden /v1/scrapes-Endpunkt abgerechnet.
Show child attributes
Show child attributes
Antwort
Erfolgreiche Antwort mit Suchergebnissen.
Auf diese Suche angewendete Aufbewahrung der gespeicherten Dateien.
Show child attributes
Show child attributes
"search_9bi0sbj9xa"
"search"
1760327323
"Best Answer Engine Optimization startups"
Gesamte Credits, die durch diese Anfrage verbraucht wurden: 5 Basis-Such-Credits + Summe der pro Seite verbrauchten Scrape-Credits, wenn scrape_options verwendet wurde.
10
Show child attributes
Show child attributes
War diese Seite hilfreich?