検索
scrapeOptions に formats: [{"type": "markdown"}] を指定してください。指定しない場合は、結果 (url、title、description) がデフォルトで返されます。要約されたコンテンツが必要な場合は、{"type": "summary"} など他のフォーマットも使用できます。
サポートされているクエリ演算子
Location パラメータ
location パラメータで地域ターゲットの検索結果を取得します。形式: "string"。例: "Germany"、"San Francisco,California,United States"。
利用可能な国と言語の一覧は、サポート対象ロケーションの全リストをご覧ください。
Country パラメータ
country パラメータで、ISO の国コードを用いて検索結果の対象国を指定します。既定値: "US"。
例: "US", "DE", "FR", "JP", "UK", "CA"。
Categories パラメータ
categories パラメータを使用して、特定のカテゴリで検索結果を絞り込みます。
github: GitHub リポジトリ、コード、Issue、ドキュメントを検索research: Web 検索を学術・研究 Web サイト (arxiv.org、nature.com、ieee.org、pubmed.ncbi.nlm.nih.gov、biorxiv.org、medrxiv.org など) に限定します。論文レコードではなく、スニペット付きの通常の Web ページ結果を返しますpdf: PDF を検索developer: Developer Index を検索 — 公開コードリポジトリの Issue、マージ済みのプルリクエスト、README、および厳選されたドキュメントサイトを対象に検索します
research は論文インデックスではなく、Web サイト用のフィルターです。 このエンドポイントの Web 検索結果を、あらかじめ定められた学術ドメインのリストに絞り込みます。科学文献を直接検索するには、PubMed、bioRxiv、medRxiv、arXiv の論文要旨に加え、論文内のパッセージ読み取りや引用グラフの展開を利用できる Research Index の GET /search/research/papers を使用してください。使い方の例
ドメインフィルター
includeDomains を使うと結果を特定のドメインに限定でき、excludeDomains を使うと検索結果から特定のドメインを除外できます。ドメインには、プロトコルやパスを含めず、ホスト名のみを指定してください。
includeDomains と excludeDomains は同時に使用できません。
含めるドメインの例
除外ドメインの例
カテゴリレスポンス
category フィールドが含まれます。
時間ベースの検索
tbs パラメータを使用すると、カスタム日付範囲を含む期間で検索結果を時間別に絞り込むことができます。詳細な例とサポートされている形式については、検索機能のドキュメントを参照してください。
Firecrawl API key が必要な AI agent ですか?自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.mdを参照してください。
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ボディ
検索クエリ
500結果をカテゴリでフィルタリングするための指定。デフォルト値は [] で、この場合はカテゴリによるフィルタリングは行われません。
- GitHub
- Research
- PDF
検索結果のジオターゲティングに使用する ISO 国コード(例:US)。最適な結果を得るには、これと location パラメータの両方を設定してください。
Zero Data Retention(ZDR)向けのエンタープライズ search options。エンドツーエンドの ZDR には ["zdr"](10 credits / 10件の結果)、匿名化された ZDR には ["anon"](2 credits / 10件の結果)を使用します。利用するには、チームで有効になっている必要があります。
anon, zdr 指定したドメインからの検索結果を除外します。ドメインには、プロトコルやパスを含まないホスト名のみを指定してください。includeDomains とは併用できません。
検索結果に対して、query に関連するハイライトを生成します。false に設定すると、ハイライトなしでプロバイダーの説明またはスニペットを返します。
他の Firecrawl エンドポイントでは無効となる URL を検索結果から除外します。これにより、検索から取得したデータを他の Firecrawl API エンドポイントに渡す際のエラーを減らせます。
検索結果を指定したドメインに限定します。ドメインには、プロトコルやパスを含まないホスト名のみを指定してください。excludeDomains とは併用できません。
返す結果の最大件数(複数のソースを使用する場合は、ソースの種類ごと)
1 <= x <= 100検索結果のロケーションを指定するパラメータ(例: San Francisco,California,United States)。最適な結果を得るには、このパラメータと country パラメータの両方を設定してください。
trueの場合、検索結果から露骨なコンテンツを除外します(SafeSearch)。省略した場合は、フィルターを適用しないデフォルトの動作になります。
検索結果をスクレイピングする際のオプション
検索対象とするソース。レスポンスに含まれる配列の種類を決定します。デフォルトは ['web'] です。
- Web
- Images
- News
時間ベースの検索パラメータで、あらかじめ定義された期間(qdr:h, qdr:d, qdr:w, qdr:m, qdr:y)、カスタム日付範囲(cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY)、日付順でのソート(sbd:1)をサポートします。値は組み合わせて指定できます(例: sbd:1,qdr:w)。
このリクエスト単位の 脅威保護 オーバーライドです。指定したフィールドは、このリクエストに限り、組織のポリシー内の対応するフィールドを置き換えます。省略したフィールドには組織レベルの値がそのまま適用されます。利用するには、チームで脅威保護が有効になっている必要があります(エンタープライズ機能)。有効でない場合、リクエストは 403 で拒否されます。組織でリクエストごとのオーバーライドが無効になっている場合、このオブジェクトを含むリクエストはすべて 403 で拒否されます。チームに対して脅威保護が強制適用されている場合、mode に off は設定できません。
タイムアウト時間(ミリ秒)

