Skip to documentation
Browse documentation

Pinterest API

Extract public Pinterest profiles, boards, sections, and pin metadata.

Platform ID pinterest
Endpoints 9 capabilities
View raw

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.

Get Full Board 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.

1 credit per request
Get Board ID 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.

1 credit per request
Get Board Info 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.

1 credit per request
List Board Pins 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.

1 credit per request
Get Pin 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.

1 credit per request
List Section Pins 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.

1 credit per request
Get Section 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.

1 credit per request
Get User Boards 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.

1 credit per request
Get User 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).

1 credit per request

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.