v2の新機能
複数ソースを検索
レスポンス形式の変更
新機能
- 期間でフィルタ(「past week」「past month」)
- 特定の国や地域を指定してターゲット
- カテゴリで絞り込み:GitHub リポジトリや研究サイト内を検索
- アルファ期間中は結果を最大500件に制限
scrapeOptions に formats: [{"type": "markdown"}] を指定してください。指定しない場合は、SERP の結果(url、title、description)がデフォルトで返されます。要約コンテンツには {"type": "summary"} など他のフォーマットも使用できます。
サポートされているクエリ演算子
| 演算子 | 機能 | 例 |
|---|---|---|
"" | テキストを厳密一致で検索する | "Firecrawl" |
- | 特定のキーワードを除外、または他の演算子を否定する | -bad, -site:firecrawl.dev |
site: | 指定したサイトの結果のみを返す | site:firecrawl.dev |
inurl: | URL に特定の語を含む結果のみを返す | inurl:firecrawl |
allinurl: | URL に複数の語を含む結果のみを返す | allinurl:git firecrawl |
intitle: | ページタイトルに特定の語を含む結果のみを返す | intitle:Firecrawl |
allintitle: | ページタイトルに複数の語を含む結果のみを返す | allintitle:firecrawl playground |
related: | 特定のドメインに関連する結果のみを返す | related:firecrawl.dev |
imagesize: | 指定した寸法と完全一致の画像のみを返す | imagesize:1920x1080 |
larger: | 指定した寸法より大きい画像のみを返す | larger:1920x1080 |
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: 学術・研究サイト(arXiv、Nature、IEEE、PubMed など)を検索pdf: PDF を検索
使い方の例
カテゴリ応答
category フィールドが含まれます。
時間ベースの検索
tbs パラメータを使用すると、カスタム日付範囲を含む期間で結果を絞り込めます。詳しい例や対応フォーマットは、Search 機能のドキュメントを参照してください。Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The search query
Maximum number of results to return
1 <= x <= 100Sources to search. Will determine the arrays available in the response.
- Web
- Images
- News
Categories to filter results by
- GitHub
- Research
- PDF
Time-based search parameter. Supports predefined time ranges (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y) and custom date ranges (cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY)
Location parameter for search results (e.g. San Francisco,California,United States). For best results, set both this and the country parameter.
ISO country code for geo-targeting search results (e.g. US). For best results, set both this and the location parameter.
Timeout in milliseconds
Excludes URLs from the search results that are invalid for other Firecrawl endpoints. This helps reduce errors if you are piping data from search into other Firecrawl API endpoints.
Options for scraping search results

