# 단일 페이지를 스크레이프하여 주요 콘텐츠를 markdown으로 반환합니다.

**API:** Data API

**Endpoint:** `POST /v1/beta/firecrawl/scrape`

**Tags:** Firecrawl

URL 하나를 가져와 주요 콘텐츠를 markdown으로 반환합니다. `url`과 `proxy`는 모두 필수이며, 과금 프로필에서는 `proxy`가 `basic`이어야 합니다. `formats`가 출력을 선택합니다. `success`와 `data`를 반환하며, 여기에는 `markdown`과 페이지의 og:/twitter: 태그, `statusCode`, `sourceURL`, `language`를 담은 큰 `metadata` 객체가 포함됩니다. ⚠️ URL은 HTTPS여야 하며 PDF를 가리켜서는 안 됩니다. 둘 다 최선 노력 대신 거부됩니다. URL이 있고 텍스트가 필요할 때 사용하세요. 여러 URL을 한 번에 처리하려면 `post_firecrawl_batch_scrape`가 하나의 백그라운드 작업으로 실행하고, `extractWebContent`는 소규모 배치를 동기식으로 처리합니다. 먼저 URL을 찾으려면 `post_firecrawl_map`을 사용하세요.

### 가격 참고

- 과금 기준: 플랜 리소스 단위.
- 참고 요청 추정치: USD 0.001071.
- 단위 원가 기준: USD 0.001071.
- 리소스 단위: `firecrawl_credit`.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
- 원가 기준은 0인 경우를 포함해 최종 고객 가격을 확정하지 않습니다.

참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "additionalProperties": false,
  "properties": {
    "formats": {
      "enum": [
        [
          "markdown"
        ]
      ],
      "items": {
        "type": "string"
      },
      "maxItems": 1,
      "minItems": 1,
      "type": "array"
    },
    "onlyCleanContent": {
      "enum": [
        false
      ],
      "type": "boolean"
    },
    "proxy": {
      "enum": [
        "basic"
      ],
      "type": "string"
    },
    "url": {
      "format": "https_url",
      "type": "string",
      "description": "지원되지 않는 접미사: .pdf."
    }
  },
  "required": [
    "proxy",
    "url"
  ],
  "type": "object"
}
```

Example:

```json
{
  "proxy": "basic",
  "url": "https://example.com"
}
```

## Responses

### 200 — 스크레이프가 완료되었습니다.

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "스크레이핑이 성공하면 true입니다."
    },
    "data": {
      "type": "object",
      "properties": {
        "markdown": {
          "type": "string",
          "description": "markdown으로 스크레이핑된 페이지 콘텐츠입니다."
        },
        "metadata": {
          "type": "object",
          "description": "제목, 설명, 원본 URL, HTTP 상태와 같은 페이지 메타데이터입니다.",
          "properties": {
            "title": {
              "type": "string"
            },
            "description": {
              "type": "string"
            },
            "sourceURL": {
              "type": "string"
            },
            "statusCode": {
              "type": "integer"
            }
          }
        }
      }
    },
    "creditsUsed": {
      "type": "integer",
      "description": "요청에서 소비된 Firecrawl 크레딧입니다(페이지당 1)."
    }
  }
}
```

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```