Skip to content
Gridlode
Docs · Reference

Pinterest Profile & Board

GET /v1/social/pinterest/profile2 credits / requestcache 1440 min

A public Pinterest profile or board exactly as a logged-out visitor sees it: name, username, about, website (and whether the domain is verified), verified badge, followers, following, pin and board counts, profile views, avatar and cover, plus the most recent pins with title, description, outbound link, image, saves, reactions and date. Pass a board URL or board slug to get that board's details and pins instead. Private profiles are never returned; e-mail addresses and phone numbers in free text are masked. Unknown profiles, blocks and failures are free.

Query parameters

username
string · required
Pinterest username (e.g. 'nasa'), a profile URL, or a board URL such as https://www.pinterest.com/nasa/humans-in-space/.
board
string
Optional board slug from the board URL (e.g. 'humans-in-space'). Returns that board and its pins instead of the profile.
Default: null
limit
integer
How many recent pins to include (0-25).
Default: 10
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/social/pinterest/profile?username=nasa&limit=5" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Pinterest Profile & Board API page.