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
}
}Zoekopdracht Aanmaken
Zoek op het web met een natuurlijke taalvraag en krijg een gededupliceerde lijst van relevante links met titels en beschrijvingen terug. Het zal de query semantisch over het web zoeken en resultaten teruggeven. Optioneel kun je scrape_options doorgeven om ook elke geretourneerde URL te scrapen en markdown_content / html_content direct in elke link in te voegen. Pagina-scrapes worden automatisch in rekening gebracht bij je team via het onderliggende /v1/scrapes endpoint. Zie Zoekfunctie.
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 door om de opgeslagen bestanden van deze zoekopdracht langer te bewaren dan de standaard 7 dagen. Waarden: 7d, 10d, 30d, 60d, 90d, 180d, 365d, of never. Zie Opslag voor details.Autorisaties
Bearer authenticatie header in de vorm Bearer , waar jouw auth token is.
Body
De zoekopdracht in natuurlijke taal.
"What's going on with OpenAI's Sora shutting down?"
Bepaalt hoe lang de opgeslagen bestanden van deze zoekopdracht (het bestand en alle gescrapete linkinhoud) bewaard blijven. Als dit wordt weggelaten, worden ze 7 dagen bewaard. De waarde die van kracht is, wordt in de respons geretourneerd als storage.expires_in. Zie de Opslagsectie in de functiedocumentatie. Een ongeldige waarde retourneert 400 met code invalid_storage_expires_in.
Show child attributes
Show child attributes
Maximum aantal links om terug te geven na deduplicatie.
1 <= x <= 2510
Beperk resultaten tot deze domeinen. Alleen kale hosts — vooraanstaande http(s):// en achtervoegende schuine strepen worden automatisch verwijderd.
["nytimes.com", "wsj.com"]
Sluit resultaten uit van deze domeinen. Alleen kale hosts — vooraanstaande http(s):// en achtervoegende schuine strepen worden automatisch verwijderd.
["reddit.com"]
Vraag een directe, laag-latentie zoekopdracht aan met je query letterlijk. De standaardmodus voert een bredere zoekpass uit voor bredere resultaatdekking.
Optioneel. Wanneer opgegeven, wordt elke geretourneerde link ook gescraped en de inhoud ervan in de respons ingebed. Per-pagina scrape credits worden automatisch gefactureerd door de onderliggende /v1/scrapes endpoint.
Show child attributes
Show child attributes
Respons
Succesvolle respons met zoekresultaten.
Retentie toegepast op de opgeslagen bestanden van deze zoekopdracht.
Show child attributes
Show child attributes
"search_9bi0sbj9xa"
"search"
1760327323
"Best Answer Engine Optimization startups"
Totale credits verbruikt door deze aanvraag: 5 basiszoekcredits + som van per-pagina scrape credits wanneer scrape_options werd gebruikt.
10
Show child attributes
Show child attributes
Was deze pagina nuttig?