Pinterest API
Extract public Pinterest profiles, boards, sections, and pin metadata.
pinterest
Capabilities
Every capability uses the same POST /execute envelope. Open an endpoint for
its exact ID, input contract, code samples, cost, runtime, and illustrative output.
Each endpoint lists its cost in credits per request; the
pricing page shows what credits cost.
pinterest.board-full.get
Retrieves board pins and sections, including boards above 1,000 pins, in resumable chunks of up to 1,000 pins. Save each response and pass pagination.next_cursor as cursor while has_more is true. outcome reports continuation, upstream shortfalls or failures; stats are per response and retrieved_total is cumulative. Pin media includes video_url when recovered plus explicit media evidence.
pinterest.board-id.get
Extracts the numeric board ID from a Pinterest board URL. The board ID is required for some API operations and is extracted from the page's embedded data.
pinterest.board-info.get
Fetches board metadata without pins. Returns board name, description, pin count, section count, owner, privacy setting, cover images, and section list with pin counts.
pinterest.board-pins.list
Returns one bounded page of public board pins plus pagination.next_cursor. Keep requesting with cursor until pagination.has_more is false. Designed for large-board backups and resumable collection. Pin media includes video_url when recovered plus media_type and media_detection so unverified media is not mislabeled as a confirmed image.
pinterest.pin.get
Fetches complete metadata for a single Pinterest pin including title, description, images, engagement metrics, creator info, rich metadata, and video_url for regular and Idea video pins. media_type and media_detection expose whether video was confirmed, detected without a URL, checked, or remains unverified.
pinterest.section-pins.list
Returns one bounded page of public section pins plus pagination.next_cursor. Keep requesting with cursor until pagination.has_more is false. Designed for large-section backups and resumable collection. Pin media includes video_url when recovered plus explicit media_type and media_detection evidence.
pinterest.section.get
Retrieves section pins, including sections above 1,000 pins, in resumable chunks of up to 1,000 pins. Pass pagination.next_cursor as cursor while has_more is true. Inspect outcome for source-side limits, no progress and incomplete traversal; reported_pin_count is Pinterest metadata, while section.pin_count counts this response.
pinterest.user-boards.get
Fetches all public boards for a Pinterest user. Returns board metadata including name, description, pin count, section count, privacy setting, cover image, and owner information.
pinterest.user.get
Fetches a Pinterest user's public profile data including username, display name, follower count, profile image URL, and verification status (partner, merchant, domain verified).
Common uses
- Monitor brand-owned Pinterest profiles and boards
- Analyze board structure, sections, and publishing volume
- Collect public pin metadata and media URLs
- Archive public board content for creative research
Integration contract
A 200 response completed inline. A 202 response was queued; poll
GET /jobs/:id until it reaches completed or failed.
- Authenticate REST requests
- Poll jobs and retrieve results
- Handle errors and safe retries
- Understand credits and limits
Use Pinterest data in Claude or connect another AI client with the MCP server.