Pinterest API

Unified typed search (session tier)

Search pins, boards, or users; each result item is typed. Requires a session backend.

Trending / today's picks (session tier)

Trending / today's picks for a region. Requires a session backend.

Topic / interest detail

Topic / interest detail (taxonomy, related topics).

Pins for a topic feed (cursor-paginated)

Pins for a topic / interest feed, cursor-paginated.

Full public profile + computed insights

Public profile (name, bio, counts, verified/business flags) with computed insights.

Public boards (cursor-paginated)

A user's public boards, cursor-paginated.

Pins created or saved (cursor-paginated)

Pins created or saved by the user, cursor-paginated.

Followers (session tier)

Followers, cursor-paginated. Requires a session backend (`login_required` otherwise).

Following (session tier)

Accounts the user follows, cursor-paginated. Requires a session backend.

Computed cadence / top boards / commerce mix

The user with its computed insights block (cadence, top board, commerce ratio).

Resolve many users

Resolve up to `PINTEREST_MAX_BULK` users; per-target failures are isolated.

Board detail + computed insights

Board detail (title, description, counts, cover, owner) with computed engagement insights.

Board pins (cursor-paginated)

Pins on a board, cursor-paginated.

Board sections

A board's sections, cursor-paginated.

Pins in a board section (cursor-paginated)

Pins in a specific board section, cursor-paginated.

Board engagement / save velocity / shoppable share

The board with its computed insights block (engagement, save velocity, shoppable share).

Single pin: media variants + parsed rich-pin metadata

A single pin with image/video variants and parsed product/recipe/article metadata.

Related / more-like-this pins (cursor-paginated)

Related / "more like this" pins, cursor-paginated.

Comments (cursor-paginated)

A pin's comments, cursor-paginated.

Proxied, non-expiring image/video variant URLs

Durable proxied image/video variant URLs (source CDN URLs expire).

Resolve many pins

Resolve up to `PINTEREST_MAX_BULK` pins; per-target failures are isolated.

Subscribe a target to change webhooks

Create a monitor on a user/board/topic/pin; a worker fires the webhook on change.

Fetch a monitor

Fetch a monitor by id.

Delete a monitor

Delete a monitor by id.

Diff a user since the last snapshot

Follower/pin/board deltas since this node last saw the user.

Which tiers/backends/endpoints are enabled here

Report the fetch backend, session tier, and per-endpoint availability on this node.

Current request limits

Pagination + bulk caps and the session-tier flag.

Withhold a subject (GDPR/CCPA)

Register a data-subject erasure: the subject is withheld from responses on this node.