# 实时社交媒体 Pinterest 任务

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/business_data/social_media/pinterest/live`

**Tags:** DataForSEO

每个 `targets` 在 Pinterest 上被 Pin 的次数。按 URL 返回 `type`、`page_url` 和 `pins_count`。采用 DataForSEO 的信封结构：数据位于 `tasks[0].result`，结果状态位于 `tasks[0].status_code`——被拒绝的请求仍会返回 HTTP 200。它接受列表，因此一次调用即可检查整个站点的页面。若要获取 Pinterest 内容而非计数，pinterest 服务会直接读取该平台。

### 计费参考

- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.2428 美元。
- 参考客户倍率：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": "array",
  "items": {
    "type": "object",
    "properties": {
      "targets": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "*目标 URL* **必填字段** 目标页面应使用绝对 URL 指定（包含 http:// 或 https://）示例：`https://dataforseo.com/`**注意：** 最多可指定 10 个目标。你将按此数组中指定的每个 URL 计费"
      },
      "tag": {
        "type": "string",
        "description": "*用户自定义任务标识符* 可选字段 *字符限制为 255* 可使用此参数标识任务，并将其与结果匹配 你将在响应的 `data` 对象中找到指定的 `tag` 值"
      }
    },
    "required": [
      "targets"
    ]
  }
}
```

## Responses

### 200 — 成功响应

Headers:
- `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "*当前 API 版本*"
    },
    "version.status_code": {
      "type": "integer",
      "description": "*通用状态代码* 完整的状态代码列表见[此处](https://docs.dataforseo.com/v3/appendix/errors.md) **注意：** 强烈建议设计必要的系统来处理相关异常或错误情况"
    },
    "version.status_message": {
      "type": "string",
      "description": "*通用信息消息* 完整的通用信息消息列表见[此处](https://docs.dataforseo.com/v3/appendix/errors.md)"
    },
    "version.time": {
      "type": "string",
      "description": "*执行时间，秒*"
    },
    "version.cost": {
      "type": "number",
      "description": "*任务总费用，美元*"
    },
    "version.tasks_count": {
      "type": "integer",
      "description": "*位于 **`tasks`** 数组中的任务数量*"
    },
    "version.tasks_error": {
      "type": "integer",
      "description": "*返回错误状态的 **`tasks`** 数组中的任务数量*"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "*任务数组*"
    },
    "tasks.id": {
      "type": "string",
      "description": "*我们系统中的唯一任务标识符* 采用 [通用唯一识别码（UUID）](https://en.wikipedia.org/wiki/Universally_unique_identifier) 格式"
    },
    "tasks.status_code": {
      "type": "integer",
      "description": "*任务状态代码* 由 DataForSEO 生成；取值范围为：10000-60000"
    },
    "tasks.status_message": {
      "type": "string",
      "description": "*任务信息消息*"
    },
    "tasks.time": {
      "type": "string",
      "description": "*执行时间，秒*"
    },
    "tasks.cost": {
      "type": "number",
      "description": "*任务费用，美元*"
    },
    "tasks.result_count": {
      "type": "integer",
      "description": "*`result` 数组中的元素数量*"
    },
    "tasks.path": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "*URL 路径*"
    },
    "tasks.data": {
      "type": "object",
      "description": "*包含你在 POST 请求中指定的相同参数*"
    },
    "result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "*结果数组*"
    },
    "result.type": {
      "type": "string",
      "description": "*元素类型 = **‘social\\_media\\_pinterest\\_item’***"
    },
    "result.page_url": {
      "type": "string",
      "description": "*提供数据所对应页面的 URL* 即设置任务时你在 `targets` 数组中指定的对应 URL"
    },
    "result.pins_count": {
      "type": "integer",
      "description": "*相关 `page_url` 的 Pin 数量* [Pinterest 上的 Pin](https://help.pinterest.com/en/business/article/build-a-pin) 对应内容收藏；此字段显示使用 [Pinterest Save Button](https://developers.pinterest.com/docs/widgets/save/?) 从相关 `page_url` 发起的内容收藏次数"
    }
  }
}
```

### 400 — 无法处理该请求。请检查请求参数。

### 401 — 需要有效的 Felo API 密钥。

### 402 — 由于未满足计费要求，请求无法继续。

### 403 — 该账户无权执行此操作。

### 429 — 已达到请求或支出限额。

### 502 — 服务无法完成该请求。

### 503 — API 或计费服务暂时不可用。

### 504 — 服务在处理请求时超时。

### default — 错误响应；上游透传响应可能采用提供方格式

**application/json**

Schema:

```json
{}
```