# Pinterest Posts by user API (pinterest.user_posts)

- Canonical page: https://everyinfra.com/en/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

Pinterest Posts by user lists the Pins one account has published, given its `username`, and returns each Pin's title and description, image or video, outbound link and source domain, the board it sits on in `board_name`, repin, reaction and comment counts, dominant color and publish time. It answers what an account publishes on Pinterest and which of its Pins spread, for social teams benchmarking competitor accounts, brands checking which of their own Pins people save, and analysts studying how creators organize content into boards.

`username` is the account's short name, with or without a leading @; a full profile URL is not parsed, so take the name from the link first. Grouping rows by `board_name` shows how the account divides its content, and setting `repin_count` against `posted_at` separates recent hits from older Pins that built up saves over time. Null comment or share counts were not disclosed, which is not zero.

## 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 | Specifies the Pinterest user handle for the profile, user_posts, and boards actions, with or without a leading @. Full profile web URLs are not accepted. |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| video_url | platform-native meaning |
| media_type | platform-native meaning |
| external_link | platform-native meaning |
| source_domain | platform-native meaning |
| reaction_count | platform-native meaning |
| repin_count | platform-native meaning |
| comment_count | Comments. null means not disclosed, not 0. |
| share_count | Shares. null means not disclosed, not 0. |
| dominant_color | platform-native meaning |
| alt_text | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| board_name | platform-native meaning |
| price | Price as a number without a currency symbol; see currency. |
| platform | Source platform identifier, the same as platform in the request (for example 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": { … }
}
```

## FAQ

### What format does `username` take?

The account's short name, such as pinterest, from a profile address like pinterest.com/pinterest/. A leading @ is fine, but Pinterest Posts by user does not parse a full profile URL, so strip it down to the name. The same short name works for the Pinterest Details and Pinterest Boards capabilities.

### How do I find an account's most saved Pins?

Sort the rows by `repin_count`, the number of times each Pin was saved again, Pinterest's main measure of spread. Read `reaction_count` and `comment_count` beside it to see which Pins also draw responses, and keep `posted_at` in view, since older Pins have had longer to gather saves.

### How is Posts by user different from Pins on a board?

Pinterest Posts by user starts from an account and returns the Pins it has published, with `board_name` telling you which board each one sits on. Pinterest Pins on a board starts from a single board, named by its username/board-name path, and returns that board's contents. Use the first to profile an account and the second to study one curated collection.

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