/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 エンドポイント
インストール
基本的な使い方
レスポンス
JSON
SDKユーザー: 検索結果は汎用的な
.data 配列の下ではなく、ソースタイプごとにグループ化されています。web の結果には result.web、news には result.news、images には result.images でアクセスします。Python
JavaScript
検索結果の種類
sources パラメータで以下の特化タイプを指定できます:
web: 標準的なウェブ結果 (デフォルト)news: ニュース特化の結果images: 画像検索の結果
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
複合カテゴリ検索
cURL
ドメインフィルター
includeDomains を使用すると、検索結果を特定のドメインに限定できます。excludeDomains を使用すると、検索対象から特定のドメインを除外できます。これらのフィールドは内部的にクエリへ site: および -site: 演算子を追加するため、プロトコルやパスは含めず、ドメインだけを指定してください。
includeDomains と excludeDomains は同時に使用できません。1 回のリクエストでは、どちらか一方のみを使用してください。含めるドメイン
cURL
除外ドメイン
cURL
カテゴリのレスポンス形式
category フィールドが含まれます。
cURL
cURL
サイズフィルタ付きHD画像検索
cURL
cURL
imagesize:1920x1080- フルHD (1080p)imagesize:2560x1440- QHD (1440p)imagesize:3840x2160- 4K UHDlarger:1920x1080- HD以上larger:2560x1440- QHD以上
コンテンツのスクレイピング付き検索
scrapeOptions パラメータ経由で /scrape エンドポイントのすべてのオプションに対応しています。
スクレイプ済みコンテンツを含むレスポンス
Searchしてからスクレイピング (2ステップパターン)
高度な検索オプション
場所のカスタマイズ
時間指定検索
tbs パラメータを使って、結果を時間範囲でフィルタリングします。tbs は web ソースの結果にのみ適用され、news や images の結果には適用されない点に注意してください。時間で絞り込んだニュース結果が必要な場合は、特定のニュースドメインを対象にするために、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)
enterprise パラメータを通じて /search エンドポイント用のゼロデータ保持 (ZDR) オプションを提供しています。ZDR 検索は Enterprise プランで利用可能です。利用を開始するには、firecrawl.dev/enterprise をご覧ください。
これは、スクレイピング操作における ZDR を制御する
zeroDataRetention スクレイプオプションとは別のものです。詳細は Scrape ZDR を参照してください。enterprise パラメータは、リクエストの検索部分にのみ適用されます。エンドツーエンド ZDR
- コスト: 10 件の結果につき 10 クレジット
- パラメータ:
enterprise: ["zdr"]
cURL
匿名化された ZDR
- コスト: 10 件の結果につき 2 クレジット
- パラメータ:
enterprise: ["anon"]
cURL
検索 ZDR と Scrape ZDR の組み合わせ
scrapeOptions) とあわせて検索を使用している場合、enterprise パラメータは検索部分を対象とし、scrapeOptions の zeroDataRetention はスクレイピング部分を対象とします。両方にわたって完全な ZDR を実現するには、両方を設定してください。
cURL
コストへの影響
- 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パラメータで検索結果数を制限する
高度なスクレイピングオプション
Firecrawl API キーが必要な AI エージェントですか? 自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。
検索フィードバック
POST /v2/search/{jobId}/feedback でフィードバックを送信してください。検索ジョブに対する最初のフィードバック送信では、チームの上限の範囲内で 1 クレジットが返還される場合があり、Firecrawl の検索品質の改善にも役立ちます。詳細は Search Feedback を参照してください。
