CaptapiCaptapi
Pinterest · Guide

How to get Pinterest user boards

TL;DR
To get Pinterest user boards, sign up for a free Captapi key, then send one GET request to /v1/pinterest/user-boards with your input. You get clean JSON back in seconds for ~5 credits (0.5/result) per call — no OAuth, scraping or platform SDKs. Boards on a Pinterest profile — pinCount, coverImage (474x), privacy, sections. Board followers when scoped.
Get your free API keyAPI reference

How to get Pinterest user boards (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Pinterest User Boards API

    Send an authenticated GET request to /v1/pinterest/user-boards with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

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_..."

What the response looks like

{
  "success": true,
  "data": {
    "requested": 25,
    "totalReturned": 1,
    "listingHits": 1,
    "hasMore": false,
    "nextCursor": null,
    "boards": [
      {
        "platform": "pinterest",
        "id": "142567213143159083",
        "name": "Learn With NASA",
        "url": "https://www.pinterest.com/nasa/learn-with-nasa/",
        "description": "Activities, resources, and opportunities from NASA and its partners that are designed to engage K-12 students in the agency's missions.",
        "privacy": null,
        "pinCount": 1625,
        "followers": null,
        "sectionCount": null,
        "coverImage": "https://i.pinimg.com/upload/142567213143159083_board_thumbnail_2026-10-06-18-22-24_3330_60.jpg",
        "createdAt": null,
        "owner": {
          "username": "nasa",
          "displayName": null
        }
      }
    ],
    "truncatedReason": "profile-window",
    "username": "nasa"
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlstring YesPinterest profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
limitintegerNoMax items to return (default 10, max 200). Billed per result.
cursorstringNoPagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (max 200).
cachebooleanNoSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Frequently asked questions

What does the Pinterest User Boards API do?

The Pinterest User Boards API lets you list items in bulk with metadata from a public Pinterest user boards using one GET request to /v1/pinterest/user-boards. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Pinterest User Boards API cost?

At the default limit this endpoint costs 5 credits (0.5 per result). Billing scales with how many results you request. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Pinterest API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle access, rate limits, retries, and authentication for you.

Is the Pinterest User Boards API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get Pinterest user boards?

Start free with 100 credits — no credit card required.

Get your free API key