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
}
}创建搜索
使用自然语言查询搜索网络，并返回一个去重的相关链接列表，包括标题和描述。 它将在网络上语义搜索查询并返回结果。 可以选择传递 scrape_options 来抓取每个返回的 URL，并将 markdown_content / html_content 直接嵌入到每个链接中。页面抓取会通过底层的 /v1/scrapes 端点自动计费到你的团队。 查看 搜索功能。
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 以将此搜索的存储文件保留时间延长至默认的 7 天以上。可选值：7d、10d、30d、60d、90d、180d、365d 或 never。详情请参阅存储。授权
Bearer认证头格式为Bearer ，其中是你的认证令牌。
请求体
自然语言的搜索查询。
"What's going on with OpenAI's Sora shutting down?"
控制此搜索的存储文件（其文件和任何抓取的链接内容）保留多长时间。如果省略，它们将保留 7 天。实际生效的值在响应中以 storage.expires_in 返回。请参阅功能文档中的存储部分。无效值返回 400，代码为 invalid_storage_expires_in。
Show child attributes
Show child attributes
去重后返回的最大链接数量。
1 <= x <= 2510
将结果限制在这些域名中。仅限裸主机——前导 http(s):// 和尾部斜杠会自动去除。
["nytimes.com", "wsj.com"]
排除来自这些域名的结果。仅限裸主机——前导 http(s):// 和尾部斜杠会自动去除。
["reddit.com"]
请求使用你的查询逐字进行直接、低延迟的搜索。默认模式执行更广泛的搜索以获得更广泛的结果覆盖。
可选。当提供时，每个返回的链接也会被抓取，其内容嵌入到响应中。每页抓取的费用会通过底层的 /v1/scrapes 端点自动计费。
Show child attributes
Show child attributes
响应
成功响应，包含搜索结果。
应用于此搜索存储文件的保留。
Show child attributes
Show child attributes
"search_9bi0sbj9xa"
"search"
1760327323
"Best Answer Engine Optimization startups"
此请求消耗的总积分：5 个基础搜索积分 + 使用 scrape_options 时每页抓取积分的总和。
10
Show child attributes
Show child attributes
此页面对您有帮助吗？