Skip to main content
POST
検索を行い、必要に応じて検索結果をスクレイピングする
注意: 機能とパフォーマンスが向上した new v2 version of this API が利用可能です。
search エンドポイントは、ウェブ検索と Firecrawl のスクレイピング機能を組み合わせ、任意のクエリに対してページ全体のコンテンツを返します。 各検索結果の完全な Markdown コンテンツを取得するには、scrapeOptionsformats: ["markdown"] を指定してください。指定しない場合は、既定で結果 (url、title、description) のみが返されます。

サポートされているクエリ演算子

検索をより適切に絞り込める、さまざまなクエリ演算子をサポートしています。

Location パラメータ

location パラメータを使うと、地域に最適化された検索結果を取得できます。形式: "string"。例: "Germany""San Francisco,California,United States" 利用可能なすべての国と言語は、サポート対象ロケーションの一覧をご覧ください。 tbs パラメータを使うと、カスタムの日付範囲を含む期間で結果を絞り込めます。具体例や対応フォーマットは、検索機能のドキュメントを参照してください。

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ボディ

application/json
query
string
必須

検索クエリ

ignoreInvalidURLs
boolean
デフォルト:false

他の Firecrawl エンドポイントでは無効となる URL を検索結果から除外します。検索結果のデータを他の Firecrawl API エンドポイントにパイプで渡す場合のエラー削減に役立ちます。

limit
integer
デフォルト:5

返す結果の最大件数

必須範囲: 1 <= x <= 100
location
string

検索結果の location パラメーター

scrapeOptions
object

検索結果スクレイピングのオプション

tbs
string

時間指定の検索パラメータ。事前定義された時間範囲(qdr:hqdr:dqdr:wqdr:mqdr:y)と、カスタム日付範囲(cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY)をサポートします

threatProtection
Threat Protection Override · object

リクエスト単位の脅威保護オーバーライドです。指定したフィールドは、このリクエストに限り、組織のポリシー内の対応するフィールドを上書きします。省略したフィールドには組織レベルの値がそのまま使用されます。利用するには、チームで脅威保護(エンタープライズ機能)が有効になっている必要があります。そうでない場合、リクエストは 403 で拒否されます。組織でリクエストのオーバーライドが無効になっている場合、このオブジェクトを含むリクエストはすべて 403 で拒否されます。チームで脅威保護の適用が必須になっている場合、modeoff は設定できません。

timeout
integer
デフォルト:60000

タイムアウト(ミリ秒)

レスポンス

成功時のレスポンス

data
object[]
id
string

検索ジョブのID

success
boolean
warning
string | null

問題発生時に表示される警告メッセージ