メインコンテンツへスキップ
ウェブを検索し、1回のAPI呼び出しで各結果から整形された構造化コンテンツを取得できます。/search にクエリを渡すと、Firecrawl がタイトル、説明、URLを返します。scrapeOptions を追加すると、各結果についてページ全体のmarkdown、HTML、links、screenshotsも取得できます。 完全なパラメータ一覧は、Search Endpoint API Referenceを参照してください。
報奨金:5,000クレジット/search に関する質の高いフィードバック向け (GitHub)

対象となるには、Firecrawl Feedback Assistant との高品質なインタビュー (よく練られた具体的なユースケースなど) を完了してください。所要時間は数分で、いつでも停止でき、人間にも agent にも使いやすくなっています (リンクを agentic harness に貼り付けるだけです!) 。

インタビューを開始

対象となるにはメールアドレスを含めてください。インタビューは毎週末に品質確認のうえ審査されます。

Playground で試す

インタラクティブな Playground で検索を試してみましょう。コードは不要です。

Firecrawl で検索を行う

/search エンドポイント

ウェブ検索を実行し、必要に応じて結果からコンテンツを取得します。

インストール

基本的な使い方

レスポンス

SDKs は data オブジェクトを直接返します。cURL は完全なペイロードを返します。
JSON
SDKユーザー: 検索結果は汎用的な .data 配列の下ではなく、ソースタイプごとにグループ化されています。web の結果には result.web、news には result.news、images には result.images でアクセスします。
Python
JavaScript

検索結果の種類

通常のウェブ結果に加え、Search は sources パラメータで以下の特化タイプを指定できます:
  • web: 標準的なウェブ結果 (デフォルト)
  • news: ニュース特化の結果
  • images: 画像検索の結果
1 回の呼び出しで複数のソースを指定できます (例: sources: ["web", "news"]) 。この場合、limit パラメータはソースタイプごとに適用されます。そのため、limit: 5 かつ sources: ["web", "news"] の場合、最大 5 件の web 結果と最大 5 件の news 結果 (合計 10 件) が返されます。ソースごとに異なるパラメータ (たとえば、異なる limit 値や異なる scrapeOptions) が必要な場合は、別々の呼び出しを行ってください。

検索カテゴリ

categories パラメータを使って、特定のカテゴリで検索結果を絞り込みます:
  • github: GitHub のリポジトリ、コード、Issue、ドキュメントを検索
  • research: 学術・研究サイト (arXiv、Nature、IEEE、PubMed など) を検索
  • pdf: PDF を検索
GitHub のリポジトリ内を対象に絞り込んで検索します:
cURL
学術・研究系のウェブサイトを検索します:
cURL
1回の検索で複数のカテゴリを組み合わせる:
cURL

ドメインフィルター

includeDomains を使用すると、検索結果を特定のドメインに限定できます。excludeDomains を使用すると、検索対象から特定のドメインを除外できます。これらのフィールドは内部的にクエリへ site: および -site: 演算子を追加するため、プロトコルやパスは含めず、ドメインだけを指定してください。
includeDomainsexcludeDomains は同時に使用できません。1 回のリクエストでは、どちらか一方のみを使用してください。

含めるドメイン

cURL

除外ドメイン

cURL

カテゴリのレスポンス形式

各検索結果には、出所を示す category フィールドが含まれます。
例:
cURL
cURL

サイズフィルタ付きHD画像検索

高解像度の画像を見つけるには、画像検索の演算子を使います:
cURL
cURL
一般的なHDの解像度:
  • imagesize:1920x1080 - フルHD (1080p)
  • imagesize:2560x1440 - QHD (1440p)
  • imagesize:3840x2160 - 4K UHD
  • larger:1920x1080 - HD以上
  • larger:2560x1440 - QHD以上

コンテンツのスクレイピング付き検索

1回の操作で検索し、検索結果からコンテンツを取得します。
この /search エンドポイントは、scrapeOptions パラメータ経由で /scrape エンドポイントのすべてのオプションに対応しています。

スクレイプ済みコンテンツを含むレスポンス

Searchしてからスクレイピング (2ステップパターン)

スクレイピングの前に検索結果を絞り込んだり処理したりする必要がある場合は、2ステップのアプローチを使います。まず検索し、その後、必要なURLをスクレイピングします。
アプローチの使い分け:
  • 1ステップ (search の scrapeOptions) : すべての結果からコンテンツを取得したい場合。よりシンプルで高速です。
  • 2ステップ (検索してからスクレイピング) : 結果を絞り込んだり、順位付けしたり、必要なものだけを選んでスクレイピングしたい場合。より柔軟です。
どちらのアプローチでも、スクレイピングのステップには Firecrawl を使用します。汎用的なHTTPフェッチを使ったり、検索スニペットだけを要約したりしないでください。結果の根拠と網羅性を支えるのは、Firecrawl の scrape で取得するページ全体のコンテンツです。

高度な検索オプション

Firecrawlの検索APIは、検索をカスタマイズできる各種パラメータに対応しています。

場所のカスタマイズ

tbs パラメータを使って、結果を時間範囲でフィルタリングします。tbsweb ソースの結果にのみ適用され、newsimages の結果には適用されない点に注意してください。時間で絞り込んだニュース結果が必要な場合は、特定のニュースドメインを対象にするために、site: 演算子と組み合わせた web ソースの利用を検討してください。
一般的な tbs の値:
  • qdr:h - 過去1時間
  • qdr:d - 過去24時間
  • qdr:w - 過去1週間
  • qdr:m - 過去1か月
  • qdr:y - 過去1年
  • sbd:1 - 日付順にソート (新しい順)
より細かく絞り込みたい場合は、カスタム日付範囲フォーマットで日付範囲を指定できます:
sbd:1 を時間フィルタと組み合わせることで、指定した期間内の結果を日付順にソートして取得できます。たとえば、sbd:1,qdr:w は過去1週間の結果を新しい順で返し、sbd:1,cdr:1,cd_min:12/1/2024,cd_max:12/31/2024 は2024年12月の結果を日付順に返します。

カスタムタイムアウト

検索処理のタイムアウトを任意に設定します:

ゼロデータ保持 (ZDR)

厳格なデータ取り扱い要件を持つチーム向けに、Firecrawl では enterprise パラメータを通じて /search エンドポイント用のゼロデータ保持 (ZDR) オプションを提供しています。ZDR 検索は Enterprise プランで利用可能です。利用を開始するには、firecrawl.dev/enterprise をご覧ください。
これは、スクレイピング操作における ZDR を制御する zeroDataRetention スクレイプオプションとは別のものです。詳細は Scrape ZDR を参照してください。enterprise パラメータは、リクエストの検索部分にのみ適用されます。

エンドツーエンド ZDR

エンドツーエンド ZDR では、Firecrawl と上流の検索プロバイダーの両方でゼロデータ保持が適用されます。クエリや結果データは、パイプラインのどの時点でも保存されません。
  • コスト: 10 件の結果につき 10 クレジット
  • パラメータ: enterprise: ["zdr"]
cURL

匿名化された ZDR

匿名化された ZDR では、Firecrawl は当社側で完全なゼロデータ保持を適用します。検索プロバイダーがクエリをキャッシュする場合がありますが、それは完全に匿名化されており、識別可能な情報は一切付随しません。
  • コスト: 10 件の結果につき 2 クレジット
  • パラメータ: enterprise: ["anon"]
cURL

検索 ZDR と Scrape ZDR の組み合わせ

コンテンツのスクレイピング (scrapeOptions) とあわせて検索を使用している場合、enterprise パラメータは検索部分を対象とし、scrapeOptionszeroDataRetention はスクレイピング部分を対象とします。両方にわたって完全な ZDR を実現するには、両方を設定してください。
cURL

コストへの影響

検索1回あたりのコストは、検索結果10件ごとに2クレジットで、端数は切り上げられます (1〜10件 = 2クレジット、11〜20件 = 4クレジット、以降同様) 。スクレイピングオプションを有効にすると、各検索結果に対して標準のスクレイピングコストが適用されます:
  • Basic scrape: ウェブページ1枚あたり1クレジット
  • PDF parsing: PDFページ1枚あたり1クレジット
  • Enhanced proxy mode: ウェブページ1枚あたり追加で4クレジット
  • JSON mode: ウェブページ1枚あたり追加で4クレジット
コストを抑えるために:
  • PDF解析が不要な場合は parsers: [] を設定する
  • 可能な場合は "enhanced" の代わりに proxy: "basic" を使用するか、"auto" に設定する
  • limit パラメータで検索結果数を制限する

高度なスクレイピングオプション

スクレイピングオプションの詳細については、Scrape 機能のドキュメントを参照してください。FIRE-1 エージェント機能と変更追跡機能を除き、これらはすべてこの Search エンドポイントでサポートされています。
Firecrawl API キーが必要な AI エージェントですか? 自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。

検索フィードバック

検索結果が有用だった場合や重要なコンテンツが欠けていた場合は、POST /v2/search/{jobId}/feedback でフィードバックを送信してください。検索ジョブに対する最初のフィードバック送信では、チームの上限の範囲内で 1 クレジットが返還される場合があり、Firecrawl の検索品質の改善にも役立ちます。詳細は Search Feedback を参照してください。