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. Each endpoint lists its cost in credits per request; the pricing page shows what credits cost.

Get full board 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.

From $1.25 per 1,000 requests · 1 credit
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.

From $1.25 per 1,000 requests · 1 credit
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.

From $1.25 per 1,000 requests · 1 credit
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.

From $1.25 per 1,000 requests · 1 credit
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.

From $1.25 per 1,000 requests · 1 credit
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.

From $1.25 per 1,000 requests · 1 credit
Get section 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.

From $1.25 per 1,000 requests · 1 credit
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.

From $1.25 per 1,000 requests · 1 credit
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).

From $1.25 per 1,000 requests · 1 credit

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.

Use Pinterest data in Claude or connect another AI client with the MCP server.