# Pinterest 用户内容 API (pinterest.user_posts)

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

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | profile / user_posts / boards 的 Pinterest 用户短名，可带开头的 @；此字段不解析完整主页 URL。 |
| limit | integer (1–50) | no | 20 | 这次调用最多返回的条数，整数，1–50；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| video_url | 视频链接。 |
| media_type | 媒体类型。 |
| external_link | Pin 指向的外部链接。 |
| source_domain | 内容来源域名。 |
| reaction_count | 表情回应数。 |
| repin_count | 被转存(repin)次数。Pinterest 的核心传播指标。 |
| comment_count | 评论数。null 表示不公开，不等于 0。 |
| share_count | 分享/转发数。null 表示不公开，不等于 0。 |
| dominant_color | 主色调（十六进制），做视觉分析可直接用。 |
| alt_text | 图片替代文本。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| author_username | 作者用户名（@handle），通常可用于拼 URL。 |
| author_name | 作者昵称（显示名）。 |
| board_name | 画板名称。Pinterest 的收藏单位是画板(board)。 |
| price | 价格数值，不含货币符号；币种见 currency。 |
| 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": "user_posts",
  "params": {
    "username": "pinterest"
  }
}'
```

```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": "user_posts",
        "params": {
            "username": "pinterest",
        },
    },
    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; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "pinterest",
  "action": "user_posts",
  "results": [
    {
      "id": "•••",
      "url": "https://www.pinterest.com/pin/424605071145987859/",
      "title": "Eco Car Plate with Non-Slip Tires | Childrens Dishes, Kids Lunch Boxes, Kids Cooking Gifts",
      "text": "Mealtime with kids can be a bumpy road, but with this car-shaped plate, it's smooth cruising to the finish line. The recyclable and dishwashable racer's removable compartments and nonslip tires keep diners on track with no messy detours (i.e., the floor). Car crafted from a biode…",
      "image_url": "https://i.pinimg.com/originals/12/c1/a6/12c1a6752b29579d0d7aa3e82c8af64b.jpg",
      "media_type": "image",
      "external_link": "https://www.uncommongoods.com/product/eco-car-plate-with-non-slip-tires?utm_source=pinterest&utm_medium=paid&social&ad_id=%7Badid%7D&pin_id=%7Bpin_id%7D",
      "source_domain": "uncommongoods.com",
      "reaction_count": 56,
      "repin_count": 868,
      "dominant_color": "#f3eee3",
      "alt_text": "two plastic cars with food in them on a white surface next to cups and strawberries",
      "posted_at": "2026-09-26T09:43:33+00:00",
      "author_username": "pinterest",
      "author_name": "Pinterest",
      "board_name": "Gifts that embrace the art of play",
      "platform": "pinterest"
    },
    {
      "id": "•••",
      "url": "https://www.pinterest.com/pin/424605071145987856/",
      "title": "Healthy Harvest Natural Dining Sets | Cool & Unique Baby Gifts",
      "text": "Parents worry about everything they feed to their growing bundles of joy, but what about the plastic plates and utensils they eat off of? Here's a charming answer all-natural wooden dinnerware that’s completely free of any plastics, BPAs, or petroleum-based components. Giving a s…",
      "image_url": "https://i.pinimg.com/originals/cc/26/7d/cc267d3a3fca4beb87080cfc07c5e229.jpg",
      "media_type": "image",
      "external_link": "https://www.uncommongoods.com/product/healthy-harvest-natural-dining-sets?utm_source=pinterest&utm_medium=paid%20social&ad_id=%7Badid%7D&pin_id=%7Bpin_id%7D",
      "source_domain": "uncommongoods.com",
      "reaction_count": 155,
      "repin_count": 1904,
      "dominant_color": "#f3eadc",
      "alt_text": "three plastic fruits and vegetables are shown on a white surface with spoons, plates, and utensils",
      "posted_at": "2026-09-26T09:40:55+00:00",
      "author_username": "pinterest",
      "author_name": "Pinterest",
      "board_name": "Gifts that embrace the art of play",
      "platform": "pinterest"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## 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
