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エンドポイントを通じて自動的にあなたのチームに請求されます。 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"
}
'{
"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として返されます。機能ドキュメントのStorageセクションを参照してください。無効な値は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
このページは役に立ちましたか？