# Pinterest 画板详情 API (pinterest.board_detail)

- Canonical page: https://everyinfra.com/pinterest-api/board_detail
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "pinterest", "action": "board_detail", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Pinterest 画板详情按画板链接 `url` 读一个画板：名称、简介、Pin 数、分区数、粉丝数、是否协作画板、可见性、所有者的用户名和昵称，以及创建时间。它回答「这个画板收了多少内容、有多少人关注、归谁所有」，适合评估一个画板值不值得合作或跟踪。

画板列表返回的字段和这里相同，两页的区别在输入：只有用户名、想列出这个人的所有画板，用画板列表那一页，一次最多 50 个；手里已经是画板链接、只看这一个画板，用这一页。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=pinterest&action=board_detail

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | pin 使用含 /pin/数字ID/ 的具体 Pin 链接；board_detail 使用 /用户名/画板名/ 的画板链接，后者也接受相对路径。不能把画板 URL 当成 Pin。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| url | 该记录在原平台上的可访问链接。 |
| description | 简介或描述，通常比 text 短。 |
| pin_count | Pin 数。 |
| section_count | 画板分区数。 |
| follower_count | 粉丝数。null 表示不公开，不等于 0。 |
| cover_image_url | 封面图。 |
| is_collaborative | 是否为多人协作画板。 |
| privacy | 可见性设置。 |
| owner_username | 所有者用户名。 |
| owner_name | 所有者昵称。 |
| created_at | 创建时间，格式同 posted_at。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "pinterest",
  "action": "board_detail",
  "params": {
    "url": "https://www.pinterest.com/pinterest/official-news/"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "pinterest",
        "action": "board_detail",
        "params": {
            "url": "https://www.pinterest.com/pinterest/official-news/",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "pinterest",
  "action": "board_detail",
  "results": {
    "id": "•••",
    "name": "Official news",
    "url": "https://www.pinterest.com/pinterest/official-news/",
    "description": "Get the inside scoop on Pinterest news. Be the first to know about new products, program updates and behind-the-scenes.",
    "pin_count": 51,
    "section_count": 0,
    "follower_count": 4251514,
    "cover_image_url": "https://i.pinimg.com/200x150/15/e3/b1/15e3b17f9d7fc968276788a0c7fccb70.jpg",
    "is_collaborative": false,
    "privacy": "public",
    "owner_username": "•••",
    "owner_name": "•••",
    "platform": "pinterest"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### `url` 填什么形式的链接？

填画板链接，形如 /用户名/画板名/，完整的网址或相对路径都接受，示例是 https://www.pinterest.com/pinterest/official-news/。路径里含 /pin/ 的是单个 Pin 的链接，不是画板，填进来不对。

### `pin_count` 和 `follower_count` 怎么看？

`pin_count` 是画板里的 Pin 数，看收了多少内容；`follower_count` 是画板的粉丝数，为 null 表示不公开，不等于 0。两个数配上 `created_at`，能看出一个画板建了多久、攒下多少内容和关注。

### 怎么判断一个画板是不是多人在维护？

看 `is_collaborative`，为真表示多人协作画板。`owner_username` 和 `owner_name` 是所有者的用户名和昵称，`privacy` 是可见性设置。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=pinterest
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
