検索 - Firecrawl Docs

ウェブを検索し、1回のAPI呼び出しで各結果から整形された構造化コンテンツを取得できます。/search にqueryを渡すと、Firecrawl がタイトル、説明、URLを返します。scrapeOptions を追加すると、各結果についてページ全体のmarkdown、HTML、links、screenshotsも取得できます。

検索結果には、デフォルトでqueryに関連するハイライトが含まれます。代わりに各Web サイトの通常の説明またはスニペットを使いたい場合は、highlights を false に設定します。

完全なパラメータ一覧は、Search Endpoint API Referenceを参照してください。

Playground で試す

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

Firecrawl で検索を行う#

/search エンドポイント#

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

インストール#

報奨：5,000クレジット政府・法務ソースに関するフィードバックへの謝礼

対象となるには、Firecrawl Feedback Assistantとの内容の濃いインタビュー (具体的でよく検討されたユースケースなど) を完了してください。所要時間は数分で、いつでも中断でき、人間にもエージェントにも対応しています (エージェント用ハーネスにリンクを貼り付けるだけです) 。政府、裁判所、規制当局、公開記録のサイトを検索またはスクレイピングしており、これらのサイト特有の癖を実際に経験したことがある方には特に有用です。

インタビューを開始

対象となるにはメールアドレスを入力してください。インタビューの品質は毎週末に確認します。

基本的な使い方#

レスポンス#

SDKs は data オブジェクトを直接返します。cURL は完全なペイロードを返します。

JSON

{  "success": true,  "data": {    "web": [      {        "url": "https://www.firecrawl.dev/",        "title": "Firecrawl - AI向けWebデータAPI",        "description": "AI向けのウェブクローリング、スクレイピング、検索API。大規模運用に対応。Firecrawlはインターネット全体をAIエージェントやビルダーに提供します。",        "position": 1      },      {        "url": "https://github.com/firecrawl/firecrawl",        "title": "mendableai/firecrawl: Turn entire websites into LLM-ready ... - GitHub",        "description": "Firecrawl is an API service that takes a URL, crawls it, and converts it into clean markdown or structured data.",        "position": 2      },      ...    ],    "images": [      {        "title": "Quickstart | Firecrawl",        "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png",        "imageWidth": 5814,        "imageHeight": 1200,        "url": "https://docs.firecrawl.dev/",        "position": 1      },      ...    ],    "news": [      {        "title": "Y Combinator startup Firecrawl is ready to pay $1M to hire three AI agents as employees",        "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",        "snippet": "It's now placed three new ads on YC's job board for “AI agents only” and has set aside a $1 million budget total to make it happen.",        "date": "3 months ago",        "position": 1      },      ...    ]  }}

Note

SDKユーザー: 検索結果は汎用的な .data 配列の下ではなく、ソースタイプごとにグループ化されています。web の結果には result.web、news には result.news、images には result.images でアクセスします。

Python

result = firecrawl.search("query")for item in result.web or []:    print(item.url, item.title)

JavaScript

const result = await firecrawl.search("query");for (const item of result.web ?? []) {  console.log(item.url, item.title);}

検索結果の種類#

通常のウェブ結果に加え、Search は sources パラメータで以下の特化タイプを指定できます:

web: 標準的なウェブ結果 (デフォルト)
news: ニュース特化の結果
images: 画像検索の結果

1 回の呼び出しで複数のソースを指定できます (例: sources: ["web", "news"]) 。この場合、limit パラメータはソースタイプごとに適用されます。そのため、limit: 5 かつ sources: ["web", "news"] の場合、最大 5 件の web 結果と最大 5 件の news 結果 (合計 10 件) が返されます。ソースごとに異なるパラメータ (たとえば、異なる limit 値や異なる scrapeOptions) が必要な場合は、別々の呼び出しを行ってください。

検索カテゴリ#

categories パラメータを使用して、検索結果を特定のカテゴリに絞り込めます。

research: Web 検索を学術・研究 Web サイト (arxiv.org、nature.com、ieee.org、pubmed.ncbi.nlm.nih.gov、biorxiv.org、medrxiv.org など) に限定します。論文レコードではなく、スニペット付きの通常の Web ページ結果を返します。論文自体を検索するには、Research Index を使用してください
pdf: PDF を検索
developer: Developer Index を検索 — 公開コードリポジトリの Issue、マージ済みのプルリクエスト、README と、厳選されたドキュメントサイトが対象です

Note

research は論文インデックスではなく、Web サイトのフィルターです。 通常の Web 検索を固定の学術ドメイン一覧に限定し、それらのページのスニペットを返します。

PubMed、bioRxiv、medRxiv、arXiv の論文インデックスで、完全なアブストラクト、論文内の本文箇所、citation グラフの拡張を含む科学文献を検索するには、Research Index を使用してください。

研究カテゴリ検索#

Web 検索を学術・研究 Web サイトに限定します。ランディングページ、要旨ページ、出版社ページなど、これらのドメインでホストされている Web ページが通常のスニペットとともに返されます:

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "機械学習 トランスフォーマー",    "categories": ["research"],    "limit": 10  }'

論文を掲載するWeb サイトではなく、論文そのものを検索するには、Research Indexを使用します。PubMed、bioRxiv、medRxiv、arXivの論文要約を検索できるほか、論文内の本文箇所を読み取ることもできます:

cURL

curl -s "https://api.firecrawl.dev/v2/search/research/papers?query=CRISPR%20base%20editing%20off-target%20effects&k=10"

Developerカテゴリ検索#

コーディングに関する質問の一次情報をDeveloper Indexで検索します。

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "how do I configure retries",    "categories": ["developer"],    "limit": 10  }'

開発者向けの結果は標準の web グループで返され、各結果には category: "developer" が含まれます。developer カテゴリは他のカテゴリと組み合わせることはできません。ランク付け済み結果や一致した本文箇所、リポジトリおよびドキュメントソースでの絞り込みには、開発者検索エンドポイントを使用してください。

複合カテゴリ検索#

1回の検索で複数のカテゴリを組み合わせる：

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "ニューラルネットワーク",    "categories": ["research", "pdf"],    "limit": 15  }'

ドメインフィルター#

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

Note

includeDomains と excludeDomains は同時に使用できません。1 回のリクエストでは、どちらか一方のみを使用してください。

含めるドメイン#

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "web scraping",    "includeDomains": ["firecrawl.dev", "docs.firecrawl.dev"],    "limit": 10  }'

除外ドメイン#

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "web scraping tools",    "excludeDomains": ["example.com"],    "limit": 10  }'

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

各検索結果には、ソースを示す category フィールドが含まれます。

{  "success": true,  "data": {    "web": [      {        "url": "https://arxiv.org/abs/2024.12345",        "title": "ニューラルネットワークアーキテクチャの進展",        "description": "ニューラルネットワークの改良に関する研究論文",        "category": "research"      },      {        "url": "https://example.com/neural-networks.pdf",        "title": "ニューラルネットワークのサーベイ",        "description": "ニューラルネットワークアーキテクチャのサーベイ",        "category": "pdf"      }    ]  }}

例：

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "openai",    "sources": ["news"],    "limit": 5  }'

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "jupiter",    "sources": ["images"],    "limit": 8  }'

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

高解像度の画像を見つけるには、画像検索の演算子を使います：

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "sunset imagesize:1920x1080",    "sources": ["images"],    "limit": 5  }'

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "mountain wallpaper larger:2560x1440",    "sources": ["images"],    "limit": 8  }'

一般的なHDの解像度:

imagesize:1920x1080 - フルHD (1080p)
imagesize:2560x1440 - QHD (1440p)
imagesize:3840x2160 - 4K UHD
larger:1920x1080 - HD以上
larger:2560x1440 - QHD以上

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

1回の操作で検索し、検索結果からコンテンツを取得します。

この /search エンドポイントは、scrapeOptions パラメータ経由で /scrape エンドポイントのすべてのオプションに対応しています。

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

{  "success": true,  "data": [    {      "title": "Firecrawl - 究極のWebスクレイピングAPI",      "description": "Firecrawl は、あらゆるウェブサイトを AI や分析向けのクリーンで構造化されたデータに変換する強力なWebスクレイピングAPIです。",      "url": "https://firecrawl.dev/",      "markdown": "# Firecrawl\n\n究極のWebスクレイピングAPI\n\n## あらゆるウェブサイトをクリーンで構造化されたデータに変換\n\nFirecrawl は、AIアプリケーション、市場調査、コンテンツ集約などに向けて、ウェブサイトからデータを手軽に抽出できます...",      "links": [        "https://firecrawl.dev/pricing",        "https://firecrawl.dev/docs",        "https://firecrawl.dev/guides"      ],      "metadata": {        "title": "Firecrawl - 究極のWebスクレイピングAPI",        "description": "Firecrawl は、あらゆるウェブサイトを AI や分析向けのクリーンで構造化されたデータに変換する強力なWebスクレイピングAPIです。"        "sourceURL": "https://firecrawl.dev/",        "statusCode": 200      }    }  ]}

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

スクレイピングの前に検索結果を絞り込んだり処理したりする必要がある場合は、2ステップのアプローチを使います。まず検索し、その後、必要なURLをスクレイピングします。

from firecrawl import Firecrawlfirecrawl = Firecrawl(api_key="fc-YOUR_API_KEY")# ステップ 1: 検索results = firecrawl.search("firecrawl web scraping", limit=5)# ステップ 2: 各結果のURLをスクレイピングしてページ全体のコンテンツを取得for item in results.web or []:    page = firecrawl.scrape(item.url, formats=["markdown"])    print(page.markdown[:200])

Tip

アプローチの使い分け:

1ステップ (search の scrapeOptions) : すべての結果からコンテンツを取得したい場合。よりシンプルで高速です。
2ステップ (検索してからスクレイピング) : 結果を絞り込んだり、順位付けしたり、必要なものだけを選んでスクレイピングしたい場合。より柔軟です。

どちらのアプローチでも、スクレイピングのステップには Firecrawl を使用します。汎用的なHTTPフェッチを使ったり、検索スニペットだけを要約したりしないでください。結果の根拠と網羅性を支えるのは、Firecrawl の scrape で取得するページ全体のコンテンツです。

高度な検索オプション#

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

場所のカスタマイズ#

時間指定検索#

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 - 日付順にソート (新しい順)

より細かく絞り込みたい場合は、カスタム日付範囲フォーマットで日付範囲を指定できます:

from firecrawl import Firecrawl# APIキーでクライアントを初期化firecrawl = Firecrawl(api_key="fc-YOUR_API_KEY")# 2024年12月の結果を検索search_result = firecrawl.search(    "firecrawl updates",    limit=10,    tbs="cdr:1,cd_min:12/1/2024,cd_max:12/31/2024")

sbd:1 を時間フィルタと組み合わせることで、指定した期間内の結果を日付順にソートして取得できます。たとえば、sbd:1,qdr:w は過去1週間の結果を新しい順で返し、sbd:1,cdr:1,cd_min:12/1/2024,cd_max:12/31/2024 は2024年12月の結果を日付順に返します。

カスタムタイムアウト#

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

from firecrawl import Firecrawl# APIキーでクライアントを初期化firecrawl = Firecrawl(api_key="fc-YOUR_API_KEY")# タイムアウトを30秒に設定search_result = firecrawl.search(    "complex search query",    limit=10,    timeout=30000  # ミリ秒単位で30秒)

セーフサーチ#

safe を true に設定すると、検索結果から露骨なコンテンツを絞り込めます (セーフサーチ) 。省略した場合は、従来どおりフィルタリングされていない結果が返されます。

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "firecrawl",    "safe": true  }'

ゼロデータ保持 (ZDR)#

厳格なデータ取り扱い要件を持つチーム向けに、Firecrawl では enterprise パラメータを通じて /search エンドポイント用のゼロデータ保持 (ZDR) オプションを提供しています。ZDR 検索は Enterprise プランで利用可能です。利用を開始するには、firecrawl.dev/enterprise をご覧ください。

Note

これは、スクレイピング操作における ZDR を制御する zeroDataRetention スクレイプオプションとは別のものです。詳細は Scrape ZDR を参照してください。enterprise パラメータは、リクエストの検索部分にのみ適用されます。

エンドツーエンド ZDR#

エンドツーエンド ZDR では、Firecrawl と上流の検索プロバイダーの両方でゼロデータ保持が適用されます。クエリや結果データは、パイプラインのどの時点でも保存されません。

コスト: 10 件の結果につき 10 クレジット
パラメータ: enterprise: ["zdr"]

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "sensitive topic",    "limit": 10,    "enterprise": ["zdr"]  }'

匿名化された ZDR#

匿名化された ZDR では、Firecrawl は当社側で完全なゼロデータ保持を適用します。検索プロバイダーがクエリをキャッシュする場合がありますが、それは完全に匿名化されており、識別可能な情報は一切付随しません。

コスト: 10 件の結果につき 2 クレジット
パラメータ: enterprise: ["anon"]

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "sensitive topic",    "limit": 10,    "enterprise": ["anon"]  }'

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

コンテンツのスクレイピング (scrapeOptions) とあわせて検索を使用している場合、enterprise パラメータは、結果として得られるすべてのスクレイピングに対して自動的に ZDR を適用します。以下のリクエスト例では、プロセスの検索部分とスクレイピング部分の両方に ZDR を適用します。

cURL

curl -X POST https://api.firecrawl.dev/v2/search \  -H "Content-Type: application/json" \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -d '{    "query": "sensitive topic",    "limit": 5,    "enterprise": ["zdr"],    "scrapeOptions": {      "formats": ["markdown"]    }  }'

コストへの影響#

検索1回あたりのコストは、検索結果10件ごとに2クレジットで、端数は切り上げられます (1〜10件 = 2クレジット、11〜20件 = 4クレジット、以降同様) 。スクレイピングオプションを有効にすると、各検索結果に対して標準のスクレイピングコストが適用されます：

Basic scrape: ウェブページ1枚あたり1クレジット
PDF parsing: PDFページ1枚あたり1クレジット
JSON mode: ウェブページ1枚あたり追加で4クレジット

コストを抑えるために:

PDF解析が不要な場合は parsers: [] を設定する
limit パラメータで検索結果数を制限する

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

スクレイピングオプションの詳細については、Scrape 機能のドキュメントを参照してください。FIRE-1 エージェント機能と変更追跡機能を除き、これらはすべてこの Search エンドポイントでサポートされています。

Firecrawl API キーが必要な AI エージェントですか？自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。

検索フィードバック#

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