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.
pinterest.board-full.get
Compatibility endpoint for bounded board snapshots. For large or complete backups, use pinterest.board-pins.list and follow pagination.next_cursor; unbounded boards over 1,000 pins are rejected instead of returning silent partial data. Pin media includes video_url when recovered plus explicit media_type and media_detection 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
Compatibility endpoint for small section snapshots. Sections reporting or returning more than 1,000 pins are rejected instead of returning silent partial data; use pinterest.section-pins.list for large or resumable backups. Returned pins include video_url when recovered plus explicit media_type and media_detection evidence.
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.