# 擷取 URL 的乾淨結構化內容。

**API:** Data API

**Endpoint:** `POST /v1/beta/byteplus/fetch`

**Tags:** BytePlus

擷取單一 URL，傳回乾淨且結構化的頁面內容——標題、本文與發布時間。`Url` 為必填。回應包裝了 `ResponseMetadata.RequestId` 與包含解析內容的 `Result` 物件。可用來為已持有的 URL 擷取完整頁面內容，通常搭配 `post_byteplus_web_search` 的結果使用。

### 定價參考

- 計量方式：以成功請求為固定成本基礎。
- 參考請求預估：USD 0.0008。
- 參考客戶乘數：1.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
{
  "type": "object",
  "properties": {
    "Url": {
      "type": "string",
      "description": "要擷取的 URL。必填。",
      "example": "https://example.com"
    }
  },
  "required": [
    "Url"
  ]
}
```

Example:

```json
{
  "Url": "https://example.com"
}
```

## Responses

### 200 — 擷取成功完成。`Result` 包含結構化的頁面內容。

Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "ResponseMetadata": {
      "type": "object",
      "description": "上游請求中繼資料。",
      "properties": {
        "RequestId": {
          "type": "string",
          "description": "此請求的唯一識別碼。"
        },
        "Action": {
          "type": "string"
        },
        "Version": {
          "type": "string"
        },
        "Service": {
          "type": "string"
        },
        "Region": {
          "type": "string"
        }
      }
    },
    "Result": {
      "type": "object",
      "description": "擷取結果內容。",
      "properties": {
        "Data": {
          "type": "object",
          "description": "結構化頁面內容。",
          "properties": {
            "StatusCode": {
              "type": "integer",
              "description": "所擷取頁面的 HTTP 狀態碼。"
            },
            "Url": {
              "type": "string",
              "description": "擷取的 URL。"
            },
            "Title": {
              "type": "string",
              "description": "頁面標題。"
            },
            "PublishTime": {
              "type": "integer",
              "description": "偵測到的發布時間，Unix 秒（未知時為 0）。"
            },
            "ContentText": {
              "type": "string",
              "description": "從頁面擷取的乾淨本文文字。"
            }
          }
        },
        "LogId": {
          "type": "string",
          "description": "上游日誌 ID（等於 ResponseMetadata.RequestId）。"
        }
      }
    }
  }
}
```

Example:

```json
{
  "ResponseMetadata": {
    "RequestId": "20260904155514D7EA140BFD77348BC3FC",
    "Action": "",
    "Version": "",
    "Service": "",
    "Region": ""
  },
  "Result": {
    "Data": {
      "StatusCode": 200,
      "Url": "https://example.com",
      "Title": "Example Domain",
      "PublishTime": 0,
      "ContentText": "This domain is for use in documentation examples without needing permission. Avoid use in operations.\nLearn more"
    },
    "LogId": "20260904155514D7EA140BFD77348BC3FC"
  }
}
```

### 400 — 無法處理該要求。請檢查請求參數。

### 401 — 需要有效的 Felo API 金鑰。

### 402 — 由於未符合計費要求，要求無法繼續。

### 403 — 該帳戶無權執行此操作。

### 429 — 已達到要求或支出上限。

### 502 — 服務無法完成該要求。

### 503 — API 或計費服務暫時無法使用。

### 504 — 服務在處理要求時逾時。

### default — 錯誤回應；上游透傳回應可能採用供應商格式

**application/json**

Schema:

```json
{}
```