All-in-One Pinterest Scraper

The Actor collects five Pinterest datasets — Pin detail, keyword search, profiles, a profile's boards, and a board's Pins — through a single run configuration. The dataset is chosen with View; each mode reads its own identifier and returns that dataset's fields.

Callers who only ever need one of these are better served by the focused Actor for it, listed at the end. This Actor exists for workflows that need several, or that would rather integrate once.

Modes

View	Identifier	Returns
Pin detail	pin_id_or_url	One Pin: title, description, media, save and comment counts, the board it sits on, and its pinner
Pin search	query	Pins matching a keyword, with scope selecting the search surface
Profile	username_or_url	One public profile: display name, follower and following counts, board and Pin counts
Boards	username_or_url	The boards a profile owns, each with its Pin count and cover Pin
Board Pins	board_id_or_url	The Pins saved to one board

View is the only required input. Each mode raises a clear error when the identifier it needs is absent, so an otherwise empty run fails immediately rather than returning an unexpected dataset.

Enrichment

Five optional add-ons attach related records to rows that would otherwise carry only an identifier. Each costs one extra request per enriched row and is charged per row it successfully enriches.

Add-on	Attaches
addonPinDetails	Full Pin detail on each search result
addonPinnerProfile	The pinner's profile on a Pin
addonBoards	A profile's boards on the profile row
addonBoardPins	A board's Pins, paginated to maxPinsPerBoard
addonCoverPinDetails	Full detail for each board's cover Pin

Enrichment failures do not fail the run. A row whose enrichment request fails is returned without the attached record, and nothing is charged for it.

Limits

maxItems caps the rows saved by the paginating modes — search, boards, and board Pins. Pin detail and profile lookups return one row and ignore it. Setting maxItems to 0 continues until Pinterest stops returning new records, which for a large board can be several thousand Pins.

maxBoardsPerProfile and maxPinsPerBoard bound the enrichment fan-out separately, so a profile with hundreds of boards cannot silently multiply into a very large run.

Behaviour worth knowing

Pinterest returns fewer rows than requested more often than most sources. Search results thin out well before an exhaustive count is reached, and a board with a stated Pin count frequently yields fewer, because Pins deleted or made secret still count toward the total Pinterest displays. A short result set is normal rather than a fault.

Profiles that are private, deactivated, or renamed return an empty result rather than an error. The distinction between "no such profile" and "profile with nothing public" is not exposed by the source and is therefore not inferred here.

Focused alternatives

Actor	Use instead when
Pinterest Pin Scraper	Only Pin detail is needed
Pinterest Search Scraper	Only keyword search is needed
Pinterest Profile Scraper	Only profile data is needed
Pinterest Boards Scraper	Only a profile's boards are needed
Pinterest Board Pins Scraper	Only one board's Pins are needed