Pinterest API | PandorLabs

social data api

Search, pins, user boards and board pins.

Search pins	`/v1/pinterest/search`	1 request
Pin details	`/v1/pinterest/pin`	1 request
Boards of a user	`/v1/pinterest/user/boards`	1 request
Pins on a board	`/v1/pinterest/board`	1 request

GET/v1/pinterest/search

Search pins

1 request

Finds Pinterest pins for a query. Each pin has id, url, title, description, images, link, domain, board details and pinner details. Page with cursor, and set trim for a lighter payload.

Query parameters

`query` stringrequired	Text to search for.
`cursor` string	Paging token returned by the last call. Omit it on the first request.
`trim` boolean	When true, the response is reduced to a lighter payload.

curl "https://api.pandorlabs.com/v1/pinterest/search?query=Italian+Pot+Roast" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "pins": [
    {
      "id": "643874078015272259",
      "url": "https://www.pinterest.com/pin/643874078015272259",
      "description": "#cute #animal #dog #puppy #pfp #icon #dogpfp #silly #cutepuppy #bordercollie #fyp #trend",
      "created_at": "Tue, 10 Jun 2025 21:45:32 +0000",
      "pinner": {
        "node_id": "VXNlcjo2NDM4NzQyMTUzODQxMzkwMTg=",
        "full_name": "Annika Strøm",
        "is_ads_only_profile": false,
        "username": "annikastrom2",
        "image_medium_url": "https://i.pinimg.com/75x75_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
        "is_primary_website_verified": false,
        "follower_count": 2,
        "ads_only_profile_site": null,
        "id": "643874215384139018",
        "is_verified_merchant": false,
        "image_large_url": "https://i.pinimg.com/140x140_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg",
        "verified_identity": {},
        "image_small_url": "https://i.pinimg.com/30x30_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg"
      },
      "images": {
        "170x": {
          "width": 236,
          "height": 312,
          "url": "https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "236x": {
          "width": 236,
          "height": 312,
          "url": "https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "474x": {
          "width": 474,
          "height": 626,
          "url": "https://i.pinimg.com/474x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "736x": {
          "width": 736,
          "height": 973,
          "url": "https://i.pinimg.com/736x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        },
        "orig": {
          "width": 946,
          "height": 1251,
          "url": "https://i.pinimg.com/originals/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg"
        }
      }
    }
  ],
  "cursor": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWl..."
}

GET/v1/pinterest/pin

Pin details

1 request

Returns the details of a single pin from its URL: title, description, link, dominantColor, originPinner, pinner, images in every size from imageSpec_236x to imageSpec_orig, and the visual annotations in pinJoin. Set trim for a lighter payload.

Query parameters

`url` stringrequired	Link to the Pinterest pin.
`trim` boolean	When true, the response is reduced to a lighter payload.
`cache_max_age` string	Accept a stored response up to this age. Inside that window the answer is free and comes back with `cached: true` and a `cached_at` time; past it, the request runs live for 1 request. `1d3d7d14d30d`

curl "https://api.pandorlabs.com/v1/pinterest/pin?url=https%3A%2F%2Fwww.pinterest.com%2Fpin%2F1124351863225567517%2F" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "entityId": "36662184461578355",
  "seoAltText": "a small brown dog sitting in the back seat of a car with its head hanging out",
  "originPinner": {
    "entityId": "1144125617743372495",
    "id": "VXNlcjoxMTQ0MTI1NjE3NzQzMzcyNDk1",
    "username": "Chloe_hi15",
    "imageMediumUrl": "https://i.pinimg.com/75x75_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
    "blockedByMe": false,
    "explicitlyFollowedByMe": false,
    "followerCount": 55,
    "fullName": "Chloe Marie Monroe",
    "imageLargeUrl": "https://i.pinimg.com/140x140_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
    "imageSmallUrl": "https://i.pinimg.com/30x30_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
    "isVerifiedMerchant": false,
    "verifiedIdentity": {
      "verified": null
    }
  },
  "pinner": {
    "blockedByMe": false,
    "id": "VXNlcjozNjY2MjMyMTg3NDk5NjcxNQ==",
    "entityId": "36662321874996715",
    "__typename": "User",
    "fullName": "Crystal Catlett",
    "imageSmallUrl": "https://i.pinimg.com/30x30_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
    "imageLargeUrl": "https://i.pinimg.com/140x140_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
    "explicitlyFollowedByMe": false,
    "username": "cc1025",
    "imageMediumUrl": "https://i.pinimg.com/75x75_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
    "firstName": "Crystal",
    "followerCount": 347,
    "isVerifiedMerchant": false,
    "verifiedIdentity": {
      "verified": null
    }
  },
  "imageSpec_orig": {
    "url": "https://i.pinimg.com/originals/71/5c/5d/715c5d48feb038e16f48a28e6f8ca1f3.jpg"
  },
  "description": " ",
  "shareCount": 0,
  "nativeCreator": null,
  "createdAt": "Mon, 09 Jun 2025 04:04:22 +0000",
  "repinCount": 88,
  "totalReactionCount": 88
}

GET/v1/pinterest/user/boards

Boards of a user

1 request

Lists a Pinterest user's boards page by page. Each board has name, url, description, pin_count, follower_count, owner details, cover_images and created_at. Pagination uses a cursor, and trim gives a lighter payload.

Query parameters

`handle` stringrequired	Pinterest username, as it appears in the profile URL (`broadstbullycom` in https://www.pinterest.com/broadstbullycom/).
`trim` boolean	When true, the response is reduced to a lighter payload.

curl "https://api.pandorlabs.com/v1/pinterest/user/boards?handle=broadstbullycom" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "boards": [
    {
      "id": "549580029467577434",
      "url": "https://www.pinterest.com/sharat24k/turkey-recipes/",
      "description": "",
      "follower_count": 292,
      "pin_count": 545,
      "name": "Turkey Recipes",
      "image_cover_hd_url": "https://i.pinimg.com/474x/45/00/df/4500dfc5bc8bbc15137ff9d9abf04cc1.jpg",
      "created_at": "Mon, 17 Feb 2025 02:19:26 +0000"
    }
  ],
  "cursor": "LT41NDk1ODAwMjk0Njc1Njc1O...."
}

GET/v1/pinterest/board

Pins on a board

1 request

Lists the pins on a Pinterest board, given the board URL. Each pin has id, description, title, images, board details, pin_join annotations and aggregated_pin_data. Page with cursor, and set trim for a lighter payload.

Query parameters

`url` stringrequired	Link to the Pinterest board.
`cursor` string	Paging token returned by the last call. Omit it on the first request.
`trim` boolean	When true, the response is reduced to a lighter payload.

curl "https://api.pandorlabs.com/v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Flizmrodgers%2Fmoms-night%2F" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "pins": [
    {
      "id": "549579960798399243",
      "link": "https://gekbuzz.com/crispy-air-fryer-pizza-rolls-recipe/",
      "title": "Crispy Air Fryer Pizza Rolls Recipe -",
      "board": {
        "node_id": "Qm9hcmQ6NTQ5NTgwMDI5NDY3NTc3NDM2",
        "followed_by_me": false,
        "owner": {
          "node_id": "VXNlcjo1NDk1ODAwOTgxODYwMzM3MzU=",
          "image_small_url": "https://s.pinimg.com/images/user/default_30.png",
          "is_primary_website_verified": true,
          "is_verified_merchant": false,
          "full_name": "Gekbuzz",
          "username": "sharat24k",
          "image_medium_url": "https://s.pinimg.com/images/user/default_75.png",
          "id": "549580098186033735",
          "verified_identity": {}
        },
        "privacy": "public",
        "is_collaborative": false,
        "url": "/sharat24k/pizza-recipes/",
        "layout": "default",
        "type": "board",
        "name": "Pizza Recipes",
        "id": "549580029467577436",
        "collaborated_by_me": false
      },
      "unified_user_note": "Craving a quick snack that combines cheesy goodness and crispy texture? These air fryer pizza rolls are the answer! Perfect for movie nights, parties, or just a casual treat, they pack all the flavor of your favorite pizza into a bite-sized…",
      "alt_text": "Crispy air fryer pizza rolls served with marinara sauce for dipping on a plate.",
      "rich_summary": {
        "actions": [],
        "products": [],
        "apple_touch_icon_link": null,
        "type_name": "article",
        "type": "richpingriddata",
        "id": "5aa12f54bef882f6f3cdd77234027e25",
        "favicon_link": "https://s.pinimg.com/images/default_rich_pin_favicon.png",
        "url": "https://gekbuzz.com/crispy-air-fryer-pizza-rolls-recipe/",
        "display_name": "Crispy Air Fryer Pizza Rolls Recipe -",
        "favicon_images": {
          "orig": "https://s.pinimg.com/images/default_rich_pin_favicon.png"
        },
        "display_description": "Craving a quick snack that combines cheesy goodness and crispy texture? These air fryer pizza rolls are the answer! Perfect for movie nights, parties, or just a casual treat, they pack all the flavor of your favorite pizza into a bite-sized…",
        "apple_touch_icon_images": null,
        "site_name": "gekbuzz.com"
      },
      "reaction_counts": {},
      "pinner": {
        "node_id": "VXNlcjo1NDk1ODAwOTgxODYwMzM3MzU=",
        "image_small_url": "https://s.pinimg.com/images/user/default_30.png",
        "is_primary_website_verified": true,
        "is_verified_merchant": false,
        "full_name": "Gekbuzz",
        "username": "sharat24k",
        "image_medium_url": "https://s.pinimg.com/images/user/default_75.png",
        "id": "549580098186033735",
        "verified_identity": {}
      },
      "description": "Craving a quick snack that combines cheesy goodness and crispy texture? These air fryer pizza rolls are the answer! Perfect for movie nights, parties, or just a casual treat, they pack all the flavor of your favorite pizza into a bite-sized…",
      "domain": "gekbuzz.com"
    }
  ],
  "cursor": "Y2JURlEwTVU1RWF6Rk9lbXMxV...."
}