User Boards

GET/v1/pinterest/user/boards1 credit

Lists the public boards of a Pinterest user, 10 per page, with each board's name, URL, description, pin and follower counts, owner and cover images.

01Query parameters

Name	Type	Description
handlerequired	string	The Pinterest username, e.g. `broadstbullycom`.
cursoroptional	string	The `cursor` value from the previous page, passed back unchanged to get the next page.
trimoptional	boolean	Set to `true` to receive a reduced object with fewer fields. Same price.Default: `false`

02Request

curl "https://api.scrapesocial.ai/v1/pinterest/user/boards?handle=broadstbullycom" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/pinterest/user/boards?handle=broadstbullycom

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "boards": [
    {
      "node_id": "Qm9hcmQ6MjgyODEyMTIwMjg5Mzk4MDEy",
      "tracking_params": "CwABAAAAEDE2MzQ3MDY5NzAwNDM1ODcGAAMAggA",
      "is_ads_only": false,
      "collaborated_by_me": false,
      "place_saves_count": 0,
      "board_vase": [
        {
          "link": "/ideas/phillies-wallpaper-iphone/912177234139/",
          "type": "boardvasedata",
          "text": "phillies wallpaper iphone"
        },
        {
          "link": "/ideas/phillies-phone-wallpaper/901255802877/",
          "type": "boardvasedata",
          "text": "phillies phone wallpaper"
        }
      ],
      "event_date": null,
      "created_at": "Thu, 20 Oct 2022 15:51:00 +0000",
      "should_show_board_collaborators": true,
      "url": "https://www.pinterest.com/broadstbullycom/philadelphia-phillies/",
      "should_show_more_ideas": false,
      "is_collaborative": false,
      "image_cover_url": "https://i.pinimg.com/200x150/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg",
      "followed_by_me": false,
      "id": "282812120289398012",
      "collaborator_count": 0,
      "should_show_shop_feed": false,
      "cover_pin": {
        "pin_id": "e1_AfqPShw7bjEdhEWP5pKilnLB0pvwbant9qkBQga4EW-L7YIc-hhP",
        "image_signature": "c4d642a59eec52e4d34368838ab3c909",
        "timestamp": 1715137450
      },
      "access": [],
      "collaborator_requests_enabled": false,
      "pin_count": 388,
      "event_start_date": null,
      "board_order_modified_at": "Fri, 12 Sep 2025 15:35:09 +0000",
      "follower_count": 2075,
      "archived_by_me_at": null,
      "privacy": "public",
      "description": "The best Philadelphia Phillies pins by 🚨 BSB 🚨",
      "cover_images": {
        "200x150": {
          "url": "https://i.pinimg.com/200x150/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg",
          "width": 200,
          "height": 150
        },
        "236x": {
          "url": "https://i.pinimg.com/236x/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg",
          "width": 236,
          "height": null
        }
      },
      "allow_homefeed_recommendations": true,
      "has_custom_cover": false,
      "name": "Philadelphia Phillies ❤️🤍",
      "image_cover_hd_url": "https://i.pinimg.com/474x/c4/d6/42/c4d642a59eec52e4d34368838ab3c909.jpg",
      "collaborating_users": [],
      "owner": {
        "node_id": "VXNlcjoyODI4MTIxODkwMDg0NzU1NDk=",
        "username": "BroadStBullycom",
        "is_private_profile": false,
        "ads_only_profile_site": null,
        "verified_identity": {},
        "is_verified_merchant": false,
        "domain_verified": true,
        "is_ads_only_profile": false,
        "explicitly_followed_by_me": false,
        "is_default_image": false,
        "follower_count": 2094,
        "id": "282812189008475549",
        "type": "user",
        "image_medium_url": "https://i.pinimg.com/75x75_RS/1c/82/f7/1c82f745249221256c71b8c04decb2c7.jpg",
        "full_name": "🚨BSB🚨",
        "is_partner": true
      },
      "type": "board",
      "images": {
        "236x": [
          {
            "url": "https://i.pinimg.com/236x/9e/75/d6/9e75d6b4c3102d949518ca0e5f2fd449.jpg",
            "width": 236,
            "height": 418,
            "dominant_color": "#D1B3AE"
          },
          {
            "url": "https://i.pinimg.com/236x/80/24/01/802401954745db8eb3d583e46aa1f04a.jpg",
            "width": 236,
            "height": 419,
            "dominant_color": "#07402B"
          }
        ]
      },
      "viewer_collaborator_join_requested": false,
      "section_count": 0
    },
    {
      "node_id": "Qm9hcmQ6MjgyODEyMTIwMjg5NDIzMDQ0",
      "tracking_params": "CwABAAAAEDE2MzQ3MDY5NzAwNDM1ODcGAAMAggA",
      "is_ads_only": false,
      "collaborated_by_me": false,
      "place_saves_count": 0,
      "board_vase": [
        {
          "link": "/ideas/anthony-edward’s-wallpapers/925597000385/",
          "type": "boardvasedata",
          "text": "anthony edward’s wallpapers"
        },
        {
          "link": "/ideas/anthony-edwards-iphone-wallpaper/926872833050/",
          "type": "boardvasedata",
          "text": "anthony edwards iphone wallpaper"
        }
      ],
      "event_date": null,
      "created_at": "Thu, 18 Apr 2024 22:56:33 +0000",
      "should_show_board_collaborators": true,
      "url": "https://www.pinterest.com/broadstbullycom/anthony-edwards/",
      "should_show_more_ideas": false,
      "is_collaborative": false,
      "image_cover_url": "https://i.pinimg.com/200x150/3f/c9/ff/3fc9ffd3ef48d11f2cea9f4cffc8ece9.jpg",
      "followed_by_me": false,
      "id": "282812120289423044",
      "collaborator_count": 0,
      "should_show_shop_feed": false,
      "cover_pin": {
        "pin_id": "e1_AfqPShwLPohPY_OZ1jo3atY2sP29EiDDOdFSSR7upR80LuGpnf4K",
        "image_signature": "3fc9ffd3ef48d11f2cea9f4cffc8ece9",
        "timestamp": 1713483568
      },
      "access": [],
      "collaborator_requests_enabled": false,
      "pin_count": 317,
      "event_start_date": null,
      "board_order_modified_at": "Wed, 21 May 2025 11:18:38 +0000",
      "follower_count": 2074,
      "archived_by_me_at": null,
      "privacy": "public",
      "description": "The best Anthony Edwards pins by 🚨 BSB 🚨",
      "cover_images": {
        "200x150": {
          "url": "https://i.pinimg.com/200x150/3f/c9/ff/3fc9ffd3ef48d11f2cea9f4cffc8ece9.jpg",
          "width": 200,
          "height": 150
        },
        "236x": {
          "url": "https://i.pinimg.com/236x/3f/c9/ff/3fc9ffd3ef48d11f2cea9f4cffc8ece9.jpg",
          "width": 236,
          "height": null
        }
      },
      "allow_homefeed_recommendations": true,
      "has_custom_cover": false,
      "name": "Anthony Edwards",
      "image_cover_hd_url": "https://i.pinimg.com/474x/3f/c9/ff/3fc9ffd3ef48d11f2cea9f4cffc8ece9.jpg",
      "collaborating_users": [],
      "owner": {
        "node_id": "VXNlcjoyODI4MTIxODkwMDg0NzU1NDk=",
        "username": "BroadStBullycom",
        "is_private_profile": false,
        "ads_only_profile_site": null,
        "verified_identity": {},
        "is_verified_merchant": false,
        "domain_verified": true,
        "is_ads_only_profile": false,
        "explicitly_followed_by_me": false,
        "is_default_image": false,
        "follower_count": 2094,
        "id": "282812189008475549",
        "type": "user",
        "image_medium_url": "https://i.pinimg.com/75x75_RS/1c/82/f7/1c82f745249221256c71b8c04decb2c7.jpg",
        "full_name": "🚨BSB🚨",
        "is_partner": true
      },
      "type": "board",
      "images": {
        "236x": [
          {
            "url": "https://i.pinimg.com/236x/6e/96/6e/6e966ea74419baf110176439f6a412ad.jpg",
            "width": 236,
            "height": 419,
            "dominant_color": "#5A7978"
          },
          {
            "url": "https://i.pinimg.com/236x/f3/57/e1/f357e17fc03eaed82f1cd8346074445f.jpg",
            "width": 236,
            "height": 419,
            "dominant_color": "#273B4E"
          }
        ]
      },
      "viewer_collaborator_join_requested": false,
      "section_count": 0
    }
  ],
  "cursor": "LT4yODI4MTIxMjAyODk0MjI4MzN8MTB8MTYzNDcwNjk3MDA0MzU4NypHUUwqfGU5N2M5YmMzZDNmMTg1MjkwZmY3MDBjZjZkMTIwYTBlZTBkODk4OTRmNjgxN2E3MTgwZDA5OGIzNzYxY2QzNGJ8TkVXfA=="
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Boards come in `boards`, 10 per page. Pass `cursor` from the answer back as `cursor` for the next page; it is null on the last page. An unknown user is a free 404. A user without public boards returns 200 with an empty `boards` list for 0 credits.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.