Skip to content

User Pins

GET/v1/pinterest/user/pins1 credit

Lists a Pinterest user's pins, 25 per page, newest first: every pin they saved (their own and repins of others' pins), or only the pins they created. Our own route: ScrapeCreators has no Pinterest user-pins route.

01Query parameters

NameTypeDescription
handlerequiredstringThe Pinterest username, `@name` or profile URL, e.g. `broadstbullycom`.
typeoptionalstring`saved`: every pin the user saved, including repins. `created`: only the pins the user uploaded (the profile's Created tab).Default: savedAccepted values:savedcreated
cursoroptionalstringThe `cursor` value from the previous page, passed back unchanged to get the next page.
trimoptionalbooleanSet to `true` to receive a reduced object with fewer fields. Same price.Default: false

02Request

curl "https://api.scrapesocial.ai/v1/pinterest/user/pins?handle=lizmrodgers&type=created" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/pinterest/user/pins?handle=lizmrodgers&type=created

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "pins": [
    {
      "node_id": "UGluOjYzODk0ODg4NDc0NzU4MzY4",
      "story_pin_data_id": null,
      "created_at": "Sun, 18 Oct 2026 09:54:40 +0000",
      "grid_title": "",
      "ad_match_reason": 0,
      "is_video": false,
      "utm_link": "https://www.instagram.com/reel/Demz1peOi8M/?utm_source=Pinterest&utm_medium=organic",
      "is_oos_product": false,
      "seo_noindex_reason": null,
      "is_quick_promotable": false,
      "grid_affiliate_disclosure": null,
      "image_signature": "c525af12462d75ab12362f8764c67c10",
      "is_eligible_for_web_closeup": false,
      "price_value": 0,
      "debug_info_html": null,
      "link_domain": {
        "node_id": "RG9tYWluOjY2NzAyNTY2OTY1NzQ3Mzk5OQ==",
        "official_user": {
          "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
          "blocked_by_me": false,
          "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "ads_only_profile_site": null,
          "type": "user",
          "verified_identity": {},
          "username": "lizmrodgers",
          "explicitly_followed_by_me": false,
          "is_primary_website_verified": false,
          "id": "63895025871749374",
          "is_ads_only_profile": false,
          "is_verified_merchant": false,
          "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "full_name": "Liz Rodgers - DIY | Home Decor"
        }
      },
      "collection_pin": null,
      "is_whitelisted_for_tried_it": true,
      "aggregated_pin_data": {
        "node_id": "QWdncmVnYXRlZFBpbkRhdGE6Mzk1NTU3MzkwMzg4ODIxMjU0NA==",
        "is_shop_the_look": false,
        "aggregated_stats": {
          "done": 0
        },
        "did_it_data": {
          "images_count": 0,
          "rating": -1,
          "type": "aggregateddiditdata",
          "tags": [],
          "user_count": 0,
          "recommend_scores": [
            {
              "score": 1,
              "count": 0
            },
            {
              "score": 0.5,
              "count": 0
            }
          ],
          "responses_count": 0,
          "recommended_count": 0,
          "videos_count": 0,
          "details_count": 0
        },
        "creator_analytics": null,
        "id": "3955573903888212544",
        "has_xy_tags": false
      },
      "grid_description": "Stupid Easy Fall Donuts 🍩 super simple, super quick fall flavored donuts. These also make great muffins if you don’t have the donut maker! And the applesauce keeps these light, fluffy and not as bad for you!\n\nFall donuts. Spice cake donuts. Fall treats. Fall treat ideas. Easy recipe. Easy fall recipe. Easy fall treat. Sweet treat. Easy donuts. DIY donuts. Fall ideas. Spiced donuts. \n\n#easyfallreci…",
      "comments": {
        "uri": "/v3/pins/63894888474758368/comments/",
        "data": [],
        "bookmark": null
      },
      "native_creator": {
        "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
        "blocked_by_me": false,
        "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "ads_only_profile_site": null,
        "type": "user",
        "verified_identity": {},
        "username": "lizmrodgers",
        "explicitly_followed_by_me": false,
        "is_primary_website_verified": false,
        "id": "63895025871749374",
        "is_ads_only_profile": false,
        "is_verified_merchant": false,
        "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "full_name": "Liz Rodgers - DIY | Home Decor"
      },
      "reaction_counts": {},
      "pinner": {
        "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
        "blocked_by_me": false,
        "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "ads_only_profile_site": null,
        "type": "user",
        "verified_identity": {},
        "username": "lizmrodgers",
        "explicitly_followed_by_me": false,
        "is_primary_website_verified": false,
        "id": "63895025871749374",
        "is_ads_only_profile": false,
        "is_verified_merchant": false,
        "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "full_name": "Liz Rodgers - DIY | Home Decor"
      },
      "domain": "instagram.com",
      "story_pin_data": null,
      "dominant_color": "#84603e",
      "comment_count": 0,
      "is_eligible_for_related_products": false,
      "grid_attribution": null,
      "sponsorship": null,
      "manual_interest_tags": null,
      "link_utm_applicable_and_replaced": 1,
      "price_currency": "USD",
      "should_open_in_stream": false,
      "call_to_action_text": null,
      "id": "63894888474758368",
      "tracking_params": "CwABAAAAEDEwNjgxNzQ3MTMyNzU4MzMGAAMAlQsABwAAAApuZ2FwaS9wcm9kAA",
      "link": "https://www.instagram.com/reel/Demz1peOi8M/",
      "is_eligible_for_pdp": false,
      "promoted_is_removable": false,
      "method": "instagram_api",
      "promoter": null,
      "is_repin": false,
      "repin_count": 0,
      "insertion_id": null,
      "is_quick_promotable_by_pinner": false,
      "is_promoted": false,
      "alt_text": null,
      "is_stale_product": false,
      "promoted_lead_form": null,
      "images": {
        "170x": {
          "width": 236,
          "height": 419,
          "url": "https://i.pinimg.com/236x/c5/25/af/c525af12462d75ab12362f8764c67c10.jpg"
        },
        "136x136": {
          "width": 136,
          "height": 136,
          "url": "https://i.pinimg.com/136x136/c5/25/af/c525af12462d75ab12362f8764c67c10.jpg"
        },
        "236x": {
          "width": 236,
          "height": 419,
          "url": "https://i.pinimg.com/236x/c5/25/af/c525af12462d75ab12362f8764c67c10.jpg"
        },
        "474x": {
          "width": 474,
          "height": 842,
          "url": "https://i.pinimg.com/474x/c5/25/af/c525af12462d75ab12362f8764c67c10.jpg"
        },
        "736x": {
          "width": 720,
          "height": 1280,
          "url": "https://i.pinimg.com/736x/c5/25/af/c525af12462d75ab12362f8764c67c10.jpg"
        },
        "orig": {
          "width": 720,
          "height": 1280,
          "url": "https://i.pinimg.com/originals/c5/25/af/c525af12462d75ab12362f8764c67c10.jpg"
        }
      },
      "shopping_flags": [],
      "board": {
        "node_id": "Qm9hcmQ6NjM4OTQ5NTcxNTI3MzIwMTQ=",
        "url": "/lizmrodgers/_tpd_social/",
        "owner": {
          "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
          "blocked_by_me": false,
          "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "ads_only_profile_site": null,
          "type": "user",
          "verified_identity": {},
          "username": "lizmrodgers",
          "explicitly_followed_by_me": false,
          "is_primary_website_verified": false,
          "id": "63895025871749374",
          "is_ads_only_profile": false,
          "is_verified_merchant": false,
          "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "full_name": "Liz Rodgers - DIY | Home Decor"
        },
        "privacy": "public",
        "name": "Social",
        "type": "board",
        "id": "63894957152732014",
        "image_thumbnail_url": "https://i.pinimg.com/upload/63894957152732014_board_thumbnail_2026-10-13-09-39-24_80605_60.jpg",
        "collaborated_by_me": false,
        "is_collaborative": false,
        "followed_by_me": false,
        "layout": "tpd_social"
      },
      "promoted_is_lead_ad": false,
      "privacy": "public",
      "description": "Stupid Easy Fall Donuts 🍩 super simple, super quick fall flavored donuts. These also make great muffins if you don’t have the donut maker! And the applesauce keeps these light, fluffy and not as bad for you!\n\nFall donuts. Spice cake donuts. Fall treats. Fall treat ideas. Easy recipe. Easy fall recipe. Easy fall treat. Sweet treat. Easy donuts. DIY donuts. Fall ideas. Spiced donuts. \n\n#easyfallreci…",
      "type": "pin",
      "campaign_id": null,
      "digital_media_source_type": null,
      "video_status_message": null,
      "rich_summary": null,
      "description_html": "Stupid Easy Fall Donuts 🍩 super simple, super quick fall flavored donuts. These also make great muffins if you don’t have the donut maker! And the applesauce keeps these light, fluffy and not as bad for you!\n\nFall donuts. Spice cake donuts. Fall treats. Fall treat ideas. Easy recipe. Easy fall recipe. Easy fall treat. Sweet treat. Easy donuts. DIY donuts. Fall ideas. Spiced donuts. \n\n<a class=\"pin…",
      "is_playable": false,
      "done_by_me": false,
      "product_metadata": null,
      "is_downstream_promotion": false,
      "creator_analytics": null,
      "carousel_data": null,
      "embed": null,
      "seo_url": "/pin/63894888474758368/",
      "auto_alt_text": null,
      "additional_hide_reasons": [],
      "seo_title": "Pinterest [Video]",
      "view_tags": [],
      "has_required_attribution_provider": false,
      "videos": {
        "node_id": "VmlkZW86NTUyNDYxMzMzODIyNjYyNDE3NQ==",
        "video_list": {
          "V_HLSV4": {
            "url": "https://v1.pinimg.com/videos/iht/hls/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.m3u8",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          },
          "V_720P": {
            "url": "https://v1.pinimg.com/videos/iht/expMp4/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb_720w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          },
          "V_HLSV3_MOBILE": {
            "url": "https://v1.pinimg.com/videos/iht/hls/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.m3u8",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          },
          "V_HEVC_MP4_T1_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb_240w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          },
          "V_HEVC_MP4_T2_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb_360w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          },
          "V_HEVC_MP4_T3_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb_540w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          },
          "V_HEVC_MP4_T4_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb_720w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          },
          "V_HEVC_MP4_T5_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb_720w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 22067,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/15/3a/2d/153a2d6df4adcf184ae6c5c7f5633bdb.0000000.jpg"
          }
        },
        "id": "5524613338226624175"
      },
      "is_uploaded": false,
      "product_pin_data": null,
      "has_been_boost_promoted": false,
      "title": "",
      "access": [],
      "attribution": null,
      "image_crop": {
        "min_y": 0,
        "max_y": 1
      },
      "is_native": true,
      "video_status": null
    },
    {
      "node_id": "UGluOjYzODk0ODg4NDc0NzQ2Mzg3",
      "story_pin_data_id": null,
      "created_at": "Wed, 14 Oct 2026 09:48:59 +0000",
      "grid_title": "",
      "ad_match_reason": 0,
      "is_video": false,
      "utm_link": "https://www.instagram.com/reel/DedDtYTsuo8/?utm_source=Pinterest&utm_medium=organic",
      "is_oos_product": false,
      "seo_noindex_reason": null,
      "is_quick_promotable": false,
      "grid_affiliate_disclosure": null,
      "image_signature": "e4caa800d2349de39d7b6e1c68c7dc6a",
      "is_eligible_for_web_closeup": false,
      "price_value": 0,
      "debug_info_html": null,
      "link_domain": {
        "node_id": "RG9tYWluOjY2NzAyNTY2OTY1NzQ3Mzk5OQ==",
        "official_user": {
          "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
          "blocked_by_me": false,
          "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "ads_only_profile_site": null,
          "type": "user",
          "verified_identity": {},
          "username": "lizmrodgers",
          "explicitly_followed_by_me": false,
          "is_primary_website_verified": false,
          "id": "63895025871749374",
          "is_ads_only_profile": false,
          "is_verified_merchant": false,
          "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "full_name": "Liz Rodgers - DIY | Home Decor"
        }
      },
      "collection_pin": null,
      "is_whitelisted_for_tried_it": true,
      "aggregated_pin_data": {
        "node_id": "QWdncmVnYXRlZFBpbkRhdGE6Mzk0Mzk2NjE3MDE1MTYwMDY0MA==",
        "is_shop_the_look": false,
        "aggregated_stats": {
          "done": 0
        },
        "did_it_data": {
          "images_count": 0,
          "rating": -1,
          "type": "aggregateddiditdata",
          "tags": [],
          "user_count": 0,
          "recommend_scores": [
            {
              "score": 1,
              "count": 0
            },
            {
              "score": 0.5,
              "count": 0
            }
          ],
          "responses_count": 0,
          "recommended_count": 0,
          "videos_count": 0,
          "details_count": 0
        },
        "creator_analytics": null,
        "id": "3943966170151600640",
        "has_xy_tags": false
      },
      "grid_description": "Best 5 bucks I’ve ever spent! \n\nHalloween decor. Funny Halloween decorations. Spooky season. Halloween decorations. Halloween flag. Spooky vibes. Fall vibes. October. Moody. \n\n#halloweendecor #spookyseason #halloweenporch #falldecor #moodyaesthetic",
      "comments": {
        "uri": "/v3/pins/63894888474746387/comments/",
        "data": [],
        "bookmark": null
      },
      "native_creator": {
        "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
        "blocked_by_me": false,
        "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "ads_only_profile_site": null,
        "type": "user",
        "verified_identity": {},
        "username": "lizmrodgers",
        "explicitly_followed_by_me": false,
        "is_primary_website_verified": false,
        "id": "63895025871749374",
        "is_ads_only_profile": false,
        "is_verified_merchant": false,
        "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "full_name": "Liz Rodgers - DIY | Home Decor"
      },
      "reaction_counts": {},
      "pinner": {
        "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
        "blocked_by_me": false,
        "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "ads_only_profile_site": null,
        "type": "user",
        "verified_identity": {},
        "username": "lizmrodgers",
        "explicitly_followed_by_me": false,
        "is_primary_website_verified": false,
        "id": "63895025871749374",
        "is_ads_only_profile": false,
        "is_verified_merchant": false,
        "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
        "full_name": "Liz Rodgers - DIY | Home Decor"
      },
      "domain": "instagram.com",
      "story_pin_data": null,
      "dominant_color": "#5e5f59",
      "comment_count": 0,
      "is_eligible_for_related_products": false,
      "grid_attribution": null,
      "sponsorship": null,
      "manual_interest_tags": null,
      "link_utm_applicable_and_replaced": 1,
      "price_currency": "USD",
      "should_open_in_stream": false,
      "call_to_action_text": null,
      "id": "63894888474746387",
      "tracking_params": "CwABAAAAEDEwNjgxNzQ3MTMyNzU4MzMGAAMAlQsABwAAAApuZ2FwaS9wcm9kAA",
      "link": "https://www.instagram.com/reel/DedDtYTsuo8/",
      "is_eligible_for_pdp": false,
      "promoted_is_removable": false,
      "method": "instagram_api",
      "promoter": null,
      "is_repin": false,
      "repin_count": 0,
      "insertion_id": null,
      "is_quick_promotable_by_pinner": false,
      "is_promoted": false,
      "alt_text": null,
      "is_stale_product": false,
      "promoted_lead_form": null,
      "images": {
        "170x": {
          "width": 236,
          "height": 418,
          "url": "https://i.pinimg.com/236x/e4/ca/a8/e4caa800d2349de39d7b6e1c68c7dc6a.jpg"
        },
        "136x136": {
          "width": 136,
          "height": 136,
          "url": "https://i.pinimg.com/136x136/e4/ca/a8/e4caa800d2349de39d7b6e1c68c7dc6a.jpg"
        },
        "236x": {
          "width": 236,
          "height": 418,
          "url": "https://i.pinimg.com/236x/e4/ca/a8/e4caa800d2349de39d7b6e1c68c7dc6a.jpg"
        },
        "474x": {
          "width": 474,
          "height": 841,
          "url": "https://i.pinimg.com/474x/e4/ca/a8/e4caa800d2349de39d7b6e1c68c7dc6a.jpg"
        },
        "736x": {
          "width": 640,
          "height": 1136,
          "url": "https://i.pinimg.com/736x/e4/ca/a8/e4caa800d2349de39d7b6e1c68c7dc6a.jpg"
        },
        "orig": {
          "width": 640,
          "height": 1136,
          "url": "https://i.pinimg.com/originals/e4/ca/a8/e4caa800d2349de39d7b6e1c68c7dc6a.jpg"
        }
      },
      "shopping_flags": [],
      "board": {
        "node_id": "Qm9hcmQ6NjM4OTQ5NTcxNTI3MzIwMTQ=",
        "url": "/lizmrodgers/_tpd_social/",
        "owner": {
          "node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
          "blocked_by_me": false,
          "image_large_url": "https://i.pinimg.com/140x140_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "ads_only_profile_site": null,
          "type": "user",
          "verified_identity": {},
          "username": "lizmrodgers",
          "explicitly_followed_by_me": false,
          "is_primary_website_verified": false,
          "id": "63895025871749374",
          "is_ads_only_profile": false,
          "is_verified_merchant": false,
          "image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
          "full_name": "Liz Rodgers - DIY | Home Decor"
        },
        "privacy": "public",
        "name": "Social",
        "type": "board",
        "id": "63894957152732014",
        "image_thumbnail_url": "https://i.pinimg.com/upload/63894957152732014_board_thumbnail_2026-10-13-09-39-24_80605_60.jpg",
        "collaborated_by_me": false,
        "is_collaborative": false,
        "followed_by_me": false,
        "layout": "tpd_social"
      },
      "promoted_is_lead_ad": false,
      "privacy": "public",
      "description": "Best 5 bucks I’ve ever spent! \n\nHalloween decor. Funny Halloween decorations. Spooky season. Halloween decorations. Halloween flag. Spooky vibes. Fall vibes. October. Moody. \n\n#halloweendecor #spookyseason #halloweenporch #falldecor #moodyaesthetic",
      "type": "pin",
      "campaign_id": null,
      "digital_media_source_type": null,
      "video_status_message": null,
      "rich_summary": null,
      "description_html": "Best 5 bucks I’ve ever spent! \n\nHalloween decor. Funny Halloween decorations. Spooky season. Halloween decorations. Halloween flag. Spooky vibes. Fall vibes. October. Moody. \n\n<a class=\"pintag\" href=\"/explore/halloweendecor/\" title=\"#halloweendecor explore Pinterest\">#halloweendecor</a> <a class=\"pintag\" href=\"/explore/spookyseason/\" title=\"#spookyseason explore Pinterest\">#spookyseason</a> <a cla…",
      "is_playable": false,
      "done_by_me": false,
      "product_metadata": null,
      "is_downstream_promotion": false,
      "creator_analytics": null,
      "carousel_data": null,
      "embed": null,
      "seo_url": "/pin/63894888474746387/",
      "auto_alt_text": "a sign that says no soliciing on it",
      "additional_hide_reasons": [],
      "seo_title": "Best 5 bucks I’ve ever spent! \n\nHalloween decor. Funny Halloween decorations. Spooky season. Halloween decorations. Hall… [Video] | Halloween decorations spooky, Halloween decorations halloween, Season halloween",
      "view_tags": [],
      "has_required_attribution_provider": false,
      "videos": {
        "node_id": "VmlkZW86NTUyMzg4ODY2MTI2Mjg5ODcxNw==",
        "video_list": {
          "V_HLSV4": {
            "url": "https://v1.pinimg.com/videos/iht/hls/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.m3u8",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          },
          "V_720P": {
            "url": "https://v1.pinimg.com/videos/iht/expMp4/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601_720w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          },
          "V_HLSV3_MOBILE": {
            "url": "https://v1.pinimg.com/videos/iht/hls/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.m3u8",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          },
          "V_HEVC_MP4_T1_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601_240w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          },
          "V_HEVC_MP4_T2_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601_360w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          },
          "V_HEVC_MP4_T3_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601_540w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          },
          "V_HEVC_MP4_T4_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601_720w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          },
          "V_HEVC_MP4_T5_V2": {
            "url": "https://v1.pinimg.com/videos/iht/hevcMp4V3/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601_720w.mp4",
            "width": 720,
            "height": 1280,
            "duration": 5333,
            "thumbnail": "https://i.pinimg.com/videos/thumbnails/originals/cd/a7/f6/cda7f6511b65e610e42fa8aef4798601.0000000.jpg"
          }
        },
        "id": "5523888661262898717"
      },
      "is_uploaded": false,
      "product_pin_data": null,
      "has_been_boost_promoted": false,
      "title": "",
      "access": [],
      "attribution": null,
      "image_crop": {
        "min_y": 0,
        "max_y": 1
      },
      "is_native": true,
      "video_status": null
    }
  ],
  "cursor": "Pz82Mzg5NDg4ODQ3Mzk4MjE1MDoxNzY3NzQwNjA1fDEwNjgxNzQ3MTMyNzU4MzMqR1FMKnw0MTM2ODE1NjRjY2M4YTg1YzNkNzQ0MTU3MmM5YjFjYTlhODEyNTUwZjc5M2FkZjIxNDRjNWE2MzZjNmI3MGRifE5FV3w="
}

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

Pins come in `pins` as Pinterest sends them (the same snake_case pin as the board route: `id, title, description, images, link, domain, board, pinner, native_creator, created_at, is_repin, reaction_counts, …`). Pass `cursor` from the answer back as `cursor` for the next page; it is null on the last page. A `created` page can hold fewer than 25 pins, and its last bookmark can lead to an empty page. With `trim=true`: `id, link, title, board, alt_text, rich_summary, reaction_counts, pinner, description, domain, created_at, images`. An unknown user is a free 404; an empty page returns 200 with an empty `pins` list for 0 credits; a cursor that is not one of ours is a free 400.

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.