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"
}
'{
"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
}
}Create Search
Search the web with a natural language query and get back a deduplicated list of relevant links with titles and descriptions.
It will search for the query semantically across the web and return results.
Optionally, pass scrape_options to also scrape every returned URL and embed markdown_content / html_content directly into each link. Page scrapes are billed automatically against your team via the underlying /v1/scrapes endpoint.
See Search feature.
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"
}
'{
"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
}
}Authorizations
Bearer authentication header of the form Bearer , where is your auth token.
Body
The search query in natural language.
"What's going on with OpenAI's Sora shutting down?"
Maximum number of links to return after deduplication.
1 <= x <= 2510
Restrict results to these domains. Bare hosts only — leading http(s):// and trailing slashes are stripped automatically.
["nytimes.com", "wsj.com"]
Exclude results from these domains. Bare hosts only — leading http(s):// and trailing slashes are stripped automatically.
["reddit.com"]
Request a direct, low-latency search using your query verbatim. Default mode performs a broader search pass for wider result coverage.
Optional. When provided, each returned link is also scraped and its content embedded into the response. Per-page scrape credits are billed automatically by the underlying /v1/scrapes endpoint.
Show child attributes
Show child attributes
Response
Successful response with search results.
"search_9bi0sbj9xa"
"search"
1760327323
"Best Answer Engine Optimization startups"
Total credits consumed by this request: 5 base search credits + sum of per-page scrape credits when scrape_options was used.
10
Show child attributes
Show child attributes
Was this page helpful?