メインコンテンツへスキップ
POST
結果の保持期間: storage.expires_in を渡すことで、このマップの保存ファイルをデフォルトの7日間より長く保持できます。値: 7d, 10d, 30d, 60d, 90d, 180d, 365d, または never。詳細はストレージを参照してください。

承認

Authorization
string
header
必須

Bearer認証ヘッダーの形式はBearer で、はあなたの認証トークンです。

ボディ

application/json
url
string<uri>
必須

リンクを取得したいウェブサイトのURL

storage
object

このマップの保存されたファイル(その結果と発見中にスクレイプされたページ)がどのくらいの期間保持されるかを制御します。省略された場合、7日間保持されます。実際の値はレスポンスでstorage.expires_inとして返されます。機能ドキュメントのストレージセクションを参照してください。無効な値は、コードinvalid_storage_expires_inで400を返します。

search_query
string

検索の関連性でリンクをソートするためのオプションの検索クエリ。

top_n
number

検索クエリの上位nリンクのみに制限するためのオプションの数。

include_subdomain
boolean

指定されたURLのサブドメインを含めます。デフォルトではtrueです。

include_urls
string[]

グロブ構文を使用して含めるURLパスパターン。例えば、/blog/**はブログURLのみを含めます。これらのパターンに一致するURLのみが返されます。

exclude_urls
string[]

グロブ構文を使用して除外するURLパスパターン。例えば、/careers/**。除外されたURLは含まれるURLよりも優先されます。

cursor
string

オプション: 前のレスポンスからのページネーションカーソル。これを提供すると、レスポンスサイズの制限で前回のリクエストが終了した場所から次のURLセットを返します。

レスポンス

ページ上で見つかったURLを含む成功したレスポンス

urls_count
integer
必須

現在のレスポンスに含まれるURLの数

urls
string[]
必須

ページ上で見つかったURLの配列

storage
object

このマップの保存されたファイルに適用される保持。

id
string

このマップの一意の識別子

cursor
string

10MBのサイズ制限のために制限された次のURLセットを取得するためのページネーションカーソル。nullまたは存在しない場合、すべてのURLが取得されています。

credits_consumed
integer | null

このリクエストで消費されたクレジットの数。実行完了後に入力されるよ。クレジットは請求の真実の源だよ。

cost_usd
number | null

このリクエストのUSDでの推定コスト。実行完了後に入力されるよ。消費されたクレジットとあなたのプランレートから計算されるよ — 99%の精度だけど、credits_consumedが権威ある値だよ。