注意: 機能とパフォーマンスが向上したnew v2 version of this APIが利用可能です。search エンドポイントは、ウェブ検索(SERP)と Firecrawl のスクレイピング機能を組み合わせ、任意のクエリに対してページ全体のコンテンツを返します。 各検索結果の完全な Markdown コンテンツを取得するには、
scrapeOptions
に formats: ["markdown"]
を指定してください。指定しない場合は、既定で SERP の結果(url、title、description)のみが返されます。
サポートされているクエリ演算子
Operator | Functionality | Examples |
---|---|---|
"" | 文字列を厳密一致させる | "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 |
Location パラメータ
location
パラメータを使うと、地域に最適化された検索結果を取得できます。形式: "string"
。例: "Germany"
、"San Francisco,California,United States"
。
利用可能なすべての国と言語は、サポート対象ロケーションの一覧をご覧ください。
時間ベース検索
tbs
パラメータを使うと、カスタムの日付範囲を含む期間で結果を絞り込めます。具体例や対応フォーマットは、検索機能のドキュメントを参照してください。Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
The search query
Maximum number of results to return
Required range:
1 <= x <= 100
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
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