Pinterest User Boards API

What is the Pinterest User Boards API?

Pass a Pinterest profile URL or username and get that profile's public boards as clean JSON. Every board row uses the same shape: id, name, url, description, privacy, pinCount, followers, sectionCount, coverImage (prefers Pinterest's 474x HD cover), createdAt (ISO-8601 UTC), and owner{username,displayName}. followers is the board-scoped follower count when available — Pinterest's logged-out board.follower_count is account-scale (identical on every board) and is never echoed here (null until a board-scoped source is wired). Billed about 0.5 credits per returned board (min 2). No cursor yet.

What you get

• Stable board row shape (same keys on every item)
• pinCount + sectionCount + privacy + description
• coverImage (474x HD when Redux exposes it)
• createdAt ISO-8601 + owner{username,displayName}
• followers only when board-scoped (else null — never account count)

Platform limits

Honest ceilings from the upstream platform surface — not Captapi bugs. Unexpected truncation here is usually the platform, not us.

• Board-scoped followers are not on the logged-out /_boards/ hydrate — followers is null rather than a misleading account twin. ScrapeCreators exposes follower_count per board from a different path.
• No cursor/hasMore yet — limit alone cannot page a profile with hundreds of boards.
• Catalog list price is ~0.5 credits/board (min 2); ScrapeCreators bills 1 credit flat for this surface.

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/pinterest/user-boards?url=https%3A%2F%2Fwww.pinterest.com%2Fnasa" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "username": "potterybarn",
    "totalReturned": 5,
    "boards": [
      {
        "platform": "pinterest",
        "id": "264938459268358811",
        "name": "Cozy Home Inspiration",
        "url": "https://www.pinterest.com/potterybarn/cozy-home-inspiration/",
        "description": null,
        "privacy": "public",
        "pinCount": 26,
        "followers": null,
        "sectionCount": 0,
        "coverImage": "https://i.pinimg.com/474x/88/13/6d/88136d3c8ce2b489f83f4b70a7afba8a.jpg",
        "createdAt": "2026-07-29T17:28:42Z",
        "owner": {
          "username": "potterybarn",
          "displayName": "Pottery Barn"
        }
      },
      {
        "platform": "pinterest",
        "id": "264938459268358699",
        "name": "Rustic Lodge Lookbook",
        "url": "https://www.pinterest.com/potterybarn/rustic-lodge-lookbook/",
        "description": null,
        "privacy": "public",
        "pinCount": 13,
        "followers": null,
        "sectionCount": 0,
        "coverImage": "https://i.pinimg.com/474x/13/37/dd/1337dd421b303196c96002b735618cc3.jpg",
        "createdAt": "2026-07-27T18:39:04Z",
        "owner": {
          "username": "potterybarn",
          "displayName": "Pottery Barn"
        }
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs ~13 credits (0.5/result) — billed per result, so the exact amount scales with how many items you request. Pass cache=true for a free 24h cache hit; default is always fresh (metrics refresh within ~1 hour).

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/pinterest/user-boards and parse the JSON response.

Use cases

Frequently asked questions

More Pinterest APIs