# はじめに (/ja/api-reference/v2-introduction)
Related: [エラー](/ja/api-reference/errors.md), [パートナー連携API](/ja/partner-integration.md)
**AI エージェント向け:** すべてのドキュメントの完全な索引については、[llms.txt](/ja/llms.txt) を参照してください。
Firecrawl API を使用すると、プログラムから Web データにアクセスできます。すべてのエンドポイントは、本ページで説明する共通のベース URL、認証方式、レスポンス形式を使用します。
## 機能 [#機能]
任意のウェブページから、markdown または json のフォーマットでコンテンツを抽出します。
ファイルをアップロードし、markdown またはその他のフォーマットに変換します。
ウェブサイト全体をクロールし、すべてのページのコンテンツを取得します。
任意のウェブサイトから URL の一覧を迅速かつ高い信頼性で取得します。
ウェブを検索し、任意のフォーマットでページ全体のコンテンツを取得します。
## エージェント機能 [#エージェント機能]
AI による自律的な Web データ収集。
インタラクティブな Web タスク向けにブラウザセッションを作成・制御します。
## ベースURL [#ベースurl]
すべてのリクエストは次のベースURLを使用します：
```bash
https://api.firecrawl.dev
```
## 認証 [#認証]
すべてのリクエストには、API キーを含む `Authorization` ヘッダーが必要です：
```bash
Authorization: Bearer fc-YOUR-API-KEY
```
すべての API 呼び出しにこのヘッダーを含めてください。API キーは [Firecrawl ダッシュボード](https://www.firecrawl.dev/app/api-keys) で確認できます。
API キーを持たないエージェントの場合は、まず [認証情報を取得](/ja/ai-onboarding#get-credentials) を参照してください。お使いのプラットフォームが WorkOS ID-JAG をサポートしている場合は、登録手順について [`auth.md`](https://www.firecrawl.dev/auth.md) を参照してください。
cURL
Python
Node
```bash
curl -X POST "https://api.firecrawl.dev/v2/scrape" \
-H "Authorization: Bearer fc-YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'
```
```python
from firecrawl import Firecrawl
firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")
result = firecrawl.scrape("https://example.com")
```
```js
import { Firecrawl } from 'firecrawl';
const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });
const result = await firecrawl.scrape('https://example.com');
```
## レスポンスコード [#レスポンスコード]
Firecrawl は、リクエストの結果を示すために標準的な HTTP ステータスコードを使用します。`2xx` 番台のコードは成功、`4xx` 番台のコードはクライアントエラー、`5xx` 番台のコードはサーバーエラーを示します。
各障害モードで返される `error` 文字列、再試行のガイダンス、コピー＆ペーストして使える backoff スニペットを含む完全なリファレンスについては、[Errors](/ja/api-reference/errors) を参照してください。
## 429 レスポンス [#429-レスポンス]
プランのレート制限または同時実行数の上限を超えると、API は `429` ステータスコードを返します。プランごとの上限については [Rate Limits](/ja/rate-limits) を、再試行のガイダンスについては [Errors](/ja/api-reference/errors) を参照してください。