Board
GET/v1/pinterest/board1 credit
Returns the pins saved on a public board, one page at a time, with each pin's title, description, images, link, pinner and repin count.
01Query parameters
| Name | Type | Description |
|---|---|---|
| urlrequired | string | The board URL, e.g. `https://www.pinterest.com/lizmrodgers/moms-night/`. |
| 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/board?url=https%3A%2F%2Fwww.pinterest.com%2Flizmrodgers%2Fmoms-night%2F" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Flizmrodgers%2Fmoms-night%2F
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"pins": [
{
"node_id": "UGluOmUxX0FmcVBTaHp4eVlGUjlZWjRNR3lDUk1ORTllaDl3X0xReEFRLWM0V3pKR2YzWDktVFpUVQ==",
"digital_media_source_type": null,
"product_pin_data": null,
"has_been_boost_promoted": false,
"dominant_color": "#8e7668",
"product_metadata": null,
"done_by_me": false,
"video_status": null,
"embed": null,
"rich_summary": null,
"shopping_flags": [],
"utm_link": null,
"reaction_counts": {
"1": 770
},
"attribution": null,
"unified_user_note": "",
"pin_join": {
"shopping_klp_urls": null,
"visual_annotation": [
"Dinner Jeans Outfit Summer",
"Jeans Dinner Outfit Summer"
],
"canonical_pin": {
"id": "e1_AfqPShyicqWqRls6AjnwUrslI3YC1nPATig3KsWy-cU"
},
"annotations_with_links": {
"Dinner Jeans Outfit Summer": {
"url": "/ideas/dinner-jeans-outfit-summer/931737761556/",
"name": "Dinner Jeans Outfit Summer"
},
"Jeans Dinner Outfit Summer": {
"url": "/ideas/jeans-dinner-outfit-summer/927170469443/",
"name": "Jeans Dinner Outfit Summer"
},
"Chic Spring Tube Top For Going Out": {
"url": "/shopping/chic-spring-tube-top-for-going-out/903716611488/",
"name": "Chic Spring Tube Top For Going Out"
},
"Trendy Strapless Denim Top": {
"url": "/shopping/trendy-strapless-denim-top/929103843455/",
"name": "Trendy Strapless Denim Top"
},
"Classy Tube Top Outfit": {
"url": "/ideas/classy-tube-top-outfit/944811151883/",
"name": "Classy Tube Top Outfit"
},
"Uo Corset Top Outfits": {
"url": "/ideas/uo-corset-top-outfits/938208869977/",
"name": "Uo Corset Top Outfits"
},
"Strapless Top And Jeans Outfit": {
"url": "/ideas/strapless-top-and-jeans-outfit/943479269645/",
"name": "Strapless Top And Jeans Outfit"
},
"Abercrombie Going Out Tops": {
"url": "/ideas/abercrombie-going-out-tops/941748611422/",
"name": "Abercrombie Going Out Tops"
},
"Zara Tube Top For Night Out In Spring": {
"url": "/shopping/zara-tube-top-for-night-out-in-spring/924849958750/",
"name": "Zara Tube Top For Night Out In Spring"
}
}
},
"favorited_by_me": false,
"promoter": null,
"image_crop": {
"min_y": 0,
"max_y": 1
},
"promoted_lead_form": null,
"domain": "Uploaded by user",
"video_status_message": null,
"is_eligible_for_pdp": false,
"link_domain": null,
"is_repin": true,
"tracking_params": "CwABAAAAEDkyMTg5MDc0NTA2OTQ3MTQGAAMAAQsABwAAAApuZ2FwaS9wcm9kCwANAAAAEDkyMTg5MDc0NTA2OTQ3MTQA",
"videos": null,
"seo_url": "/pin/e1_AfqPShzxyYFR9YZ4MGyCRMNE9eh9w_LQxAQ-c4WzJGf3X9-TZTU/",
"is_promoted": false,
"access": [],
"image_signature": "cc02402de7e71267eb829df13d49bb91",
"category": "",
"native_creator": {
"node_id": "VXNlcjo1MTU2NjIzNjM0OTI0NTEzMTA=",
"is_verified_merchant": false,
"is_primary_website_verified": false,
"full_name": "lizzy!",
"image_medium_url": "https://i.pinimg.com/75x75_RS/75/52/75/755275dc23c75ff691398c51af40ffc0.jpg",
"username": "lizzyericksonn",
"verified_identity": {},
"id": "515662363492451310",
"image_small_url": "https://i.pinimg.com/30x30_RS/75/52/75/755275dc23c75ff691398c51af40ffc0.jpg"
},
"type": "pin",
"link_utm_applicable_and_replaced": 0,
"sponsorship": null,
"favorite_user_count": 0,
"creator_analytics": null,
"promoted_is_removable": false,
"carousel_data": null,
"promoted_is_lead_ad": false,
"alt_text": null,
"is_eligible_for_related_products": false,
"grid_title": "",
"insertion_id": null,
"board": {
"node_id": "Qm9hcmQ6NjM4OTQ5NTcxNTI3MTg1MTk=",
"layout": "default",
"name": "Moms night",
"followed_by_me": false,
"privacy": "public",
"url": "/lizmrodgers/moms-night/",
"collaborated_by_me": false,
"type": "board",
"is_collaborative": false,
"owner": {
"node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
"is_verified_merchant": false,
"is_primary_website_verified": false,
"full_name": "Liz Rodgers - DIY | Home Decor",
"image_medium_url": "https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
"username": "lizmrodgers",
"verified_identity": {},
"id": "63895025871749374",
"image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg"
},
"id": "63894957152718519"
},
"is_downstream_promotion": false,
"is_quick_promotable_by_pinner": false,
"is_stale_product": false,
"story_pin_data_id": null,
"is_video": false,
"link": null,
"grid_attribution": null,
"grid_affiliate_disclosure": null,
"collection_pin": null,
"should_open_in_stream": false,
"aggregated_pin_data": {
"node_id": "QWdncmVnYXRlZFBpbkRhdGE6NTI4ODI2NzQ0NDQ1Mjg5OTYxMg==",
"creator_analytics": null,
"aggregated_stats": {
"saves": 74346,
"done": 0
},
"is_shop_the_look": false,
"did_it_data": {
"details_count": 0,
"user_count": 0,
"images_count": 0,
"responses_count": 0,
"recommend_scores": [
{
"score": 1,
"count": 0
},
{
"score": 0.5,
"count": 0
}
],
"recommended_count": 0,
"type": "aggregateddiditdata",
"rating": -1,
"videos_count": 0,
"tags": []
},
"id": "5288267444452899612"
},
"is_oos_product": false,
"id": "e1_AfqPShzxyYFR9YZ4MGyCRMNE9eh9w_LQxAQ-c4WzJGf3X9-TZTU",
"is_eligible_for_pre_loved_goods_label": false,
"auto_alt_text": null,
"title": "",
"story_pin_data": null,
"description": " ",
"pinner": {
"node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
"is_verified_merchant": false,
"is_primary_website_verified": false,
"full_name": "Liz Rodgers - DIY | Home Decor",
"image_medium_url": "https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
"username": "lizmrodgers",
"verified_identity": {},
"id": "63895025871749374",
"image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg"
},
"is_quick_promotable": false,
"images": {
"170x": {
"width": 236,
"height": 298,
"url": "https://i.pinimg.com/236x/cc/02/40/cc02402de7e71267eb829df13d49bb91.jpg"
},
"136x136": {
"width": 136,
"height": 136,
"url": "https://i.pinimg.com/136x136/cc/02/40/cc02402de7e71267eb829df13d49bb91.jpg"
},
"236x": {
"width": 236,
"height": 298,
"url": "https://i.pinimg.com/236x/cc/02/40/cc02402de7e71267eb829df13d49bb91.jpg"
},
"474x": {
"width": 474,
"height": 598,
"url": "https://i.pinimg.com/474x/cc/02/40/cc02402de7e71267eb829df13d49bb91.jpg"
},
"736x": {
"width": 736,
"height": 929,
"url": "https://i.pinimg.com/736x/cc/02/40/cc02402de7e71267eb829df13d49bb91.jpg"
},
"orig": {
"width": 950,
"height": 1200,
"url": "https://i.pinimg.com/originals/cc/02/40/cc02402de7e71267eb829df13d49bb91.jpg"
}
},
"call_to_action_text": null,
"seo_alt_text": "Dinner Jeans Outfit Summer, Jeans Dinner Outfit Summer, Chic Spring Tube Top For Going Out, Trendy Strapless Denim Top, Classy Tube Top Outfit, Uo Corset Top Outfits, Strapless Top And Jeans Outfit, Abercrombie Going Out Tops, Zara Tube Top For Night Out In Spring",
"unauth_on_page_description": "",
"is_go_linkless": false,
"campaign_id": null,
"repin_count": 0
},
{
"node_id": "UGluOmUxX0FmcVBTaHo1dDJOdjYtWkZleFZfOVhDd0tWaGRFMi0ySGNtN2lRV2otbTBzb3BQQW9EWQ==",
"digital_media_source_type": null,
"product_pin_data": null,
"has_been_boost_promoted": false,
"dominant_color": "#ffffff",
"product_metadata": null,
"done_by_me": false,
"video_status": null,
"embed": null,
"rich_summary": null,
"shopping_flags": [],
"utm_link": null,
"reaction_counts": {
"1": 255,
"11": 1
},
"attribution": null,
"unified_user_note": null,
"pin_join": {
"shopping_klp_urls": null,
"visual_annotation": [
"Vacationcore Outfit",
"Casual Mermaidcore Outfit"
],
"canonical_pin": {
"id": "e1_AfqPShye90KUEUIHYKj-IBRgz-OXtibA7RNxj5rm7B4YJ7Z-Cw"
},
"annotations_with_links": {
"Vacationcore Outfit": {
"url": "/ideas/vacationcore-outfit/953038091780/",
"name": "Vacationcore Outfit"
},
"Casual Mermaidcore Outfit": {
"url": "/ideas/casual-mermaidcore-outfit/945868213293/",
"name": "Casual Mermaidcore Outfit"
},
"Collage Dress Outfit": {
"url": "/ideas/collage-dress-outfit/939138322751/",
"name": "Collage Dress Outfit"
},
"Princesscore Summer Outfits": {
"url": "/ideas/princesscore-summer-outfits/960550438784/",
"name": "Princesscore Summer Outfits"
},
"Luxury Summer Outfits Classy": {
"url": "/ideas/luxury-summer-outfits-classy/948999358465/",
"name": "Luxury Summer Outfits Classy"
},
"Dior Summer Outfit": {
"url": "/ideas/dior-summer-outfit/924442463609/",
"name": "Dior Summer Outfit"
},
"Outfits With Dior Sandals": {
"url": "/ideas/outfits-with-dior-sandals/949978105014/",
"name": "Outfits With Dior Sandals"
},
"Zimmerman Outfit Ideas": {
"url": "/ideas/zimmerman-outfit-ideas/893430803364/",
"name": "Zimmerman Outfit Ideas"
},
"Dior Sandals Outfit Ideas": {
"url": "/ideas/dior-sandals-outfit-ideas/912634931825/",
"name": "Dior Sandals Outfit Ideas"
}
}
},
"favorited_by_me": false,
"promoter": null,
"image_crop": {
"min_y": 0,
"max_y": 1
},
"promoted_lead_form": null,
"domain": "Uploaded by user",
"video_status_message": null,
"is_eligible_for_pdp": false,
"link_domain": null,
"is_repin": true,
"tracking_params": "CwABAAAAEDkyMTg5MDc0NTA2OTQ3MTQGAAMAAQsABwAAAApuZ2FwaS9wcm9kCwANAAAAEDkyMTg5MDc0NTA2OTQ3MTQA",
"videos": null,
"seo_url": "/pin/e1_AfqPShz5t2Nv6-ZFexV_9XCwKVhdE2-2Hcm7iQWj-m0sopPAoDY/",
"is_promoted": false,
"access": [],
"image_signature": "406e979d4519d9fe0b6fd0cb2143e14b",
"category": "",
"native_creator": {
"node_id": "VXNlcjo2MDg1NDkxMDU4MDcwMjk2MjI=",
"is_verified_merchant": false,
"is_primary_website_verified": false,
"full_name": "foxy",
"image_medium_url": "https://i.pinimg.com/75x75_RS/0b/65/49/0b6549d35d79217b5f38c12bb91b4262.jpg",
"username": "ulianiaulianaa",
"verified_identity": {},
"id": "608549105807029622",
"image_small_url": "https://i.pinimg.com/30x30_RS/0b/65/49/0b6549d35d79217b5f38c12bb91b4262.jpg"
},
"type": "pin",
"link_utm_applicable_and_replaced": 0,
"sponsorship": null,
"favorite_user_count": 0,
"creator_analytics": null,
"promoted_is_removable": false,
"carousel_data": null,
"promoted_is_lead_ad": false,
"alt_text": null,
"is_eligible_for_related_products": false,
"grid_title": "👼",
"insertion_id": null,
"board": {
"node_id": "Qm9hcmQ6NjM4OTQ5NTcxNTI3MTg1MTk=",
"layout": "default",
"name": "Moms night",
"followed_by_me": false,
"privacy": "public",
"url": "/lizmrodgers/moms-night/",
"collaborated_by_me": false,
"type": "board",
"is_collaborative": false,
"owner": {
"node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
"is_verified_merchant": false,
"is_primary_website_verified": false,
"full_name": "Liz Rodgers - DIY | Home Decor",
"image_medium_url": "https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
"username": "lizmrodgers",
"verified_identity": {},
"id": "63895025871749374",
"image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg"
},
"id": "63894957152718519"
},
"is_downstream_promotion": false,
"is_quick_promotable_by_pinner": false,
"is_stale_product": false,
"story_pin_data_id": null,
"is_video": false,
"link": null,
"grid_attribution": null,
"grid_affiliate_disclosure": null,
"collection_pin": null,
"should_open_in_stream": false,
"aggregated_pin_data": {
"node_id": "QWdncmVnYXRlZFBpbkRhdGE6NTMxODI0MDUwMjU4ODQyNzA1Mw==",
"creator_analytics": null,
"aggregated_stats": {
"saves": 9094,
"done": 0
},
"is_shop_the_look": false,
"did_it_data": {
"details_count": 0,
"user_count": 0,
"images_count": 0,
"responses_count": 0,
"recommend_scores": [
{
"score": 1,
"count": 0
},
{
"score": 0.5,
"count": 0
}
],
"recommended_count": 0,
"type": "aggregateddiditdata",
"rating": -1,
"videos_count": 0,
"tags": []
},
"id": "5318240502588427053"
},
"is_oos_product": false,
"id": "e1_AfqPShz5t2Nv6-ZFexV_9XCwKVhdE2-2Hcm7iQWj-m0sopPAoDY",
"is_eligible_for_pre_loved_goods_label": false,
"auto_alt_text": null,
"title": "👼",
"story_pin_data": null,
"description": " ",
"pinner": {
"node_id": "VXNlcjo2Mzg5NTAyNTg3MTc0OTM3NA==",
"is_verified_merchant": false,
"is_primary_website_verified": false,
"full_name": "Liz Rodgers - DIY | Home Decor",
"image_medium_url": "https://i.pinimg.com/75x75_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg",
"username": "lizmrodgers",
"verified_identity": {},
"id": "63895025871749374",
"image_small_url": "https://i.pinimg.com/30x30_RS/c2/0e/62/c20e628451b24267c68924d01e42c997.jpg"
},
"is_quick_promotable": false,
"images": {
"170x": {
"width": 236,
"height": 418,
"url": "https://i.pinimg.com/236x/40/6e/97/406e979d4519d9fe0b6fd0cb2143e14b.jpg"
},
"136x136": {
"width": 136,
"height": 136,
"url": "https://i.pinimg.com/136x136/40/6e/97/406e979d4519d9fe0b6fd0cb2143e14b.jpg"
},
"236x": {
"width": 236,
"height": 418,
"url": "https://i.pinimg.com/236x/40/6e/97/406e979d4519d9fe0b6fd0cb2143e14b.jpg"
},
"474x": {
"width": 474,
"height": 841,
"url": "https://i.pinimg.com/474x/40/6e/97/406e979d4519d9fe0b6fd0cb2143e14b.jpg"
},
"736x": {
"width": 676,
"height": 1200,
"url": "https://i.pinimg.com/736x/40/6e/97/406e979d4519d9fe0b6fd0cb2143e14b.jpg"
},
"orig": {
"width": 676,
"height": 1200,
"url": "https://i.pinimg.com/originals/40/6e/97/406e979d4519d9fe0b6fd0cb2143e14b.jpg"
}
},
"call_to_action_text": null,
"seo_alt_text": "Vacationcore Outfit, Casual Mermaidcore Outfit, Collage Dress Outfit, Princesscore Summer Outfits, Luxury Summer Outfits Classy, Dior Summer Outfit, Outfits With Dior Sandals, Zimmerman Outfit Ideas, Dior Sandals Outfit Ideas",
"unauth_on_page_description": "",
"is_go_linkless": false,
"campaign_id": null,
"repin_count": 0
}
],
"cursor": "Y2JZakk0ZUU1WWR6Vk5ha1UwVDFSQk0wNUVWWGRPYW1zd1RucEZNRXRyWkZKVVEzQTRUVlJGTUU1WFVUSlBWRlpyVFhwQk5WcFhSWHBQVkZVelQxUmpNbGw2V21wTk1razBUbXBHYlUxNlRYbE9lazB6V2xSamVFMVVUVEJaYWxKcldrUlNhVTFVWXpKUFIwbDRUVmRLYWs1SFRYZE5SRlY1VFc1NFQxSldaRGc9fFVIbzVUMkl5Tld4bVJHdDVUVlJuTlUxRVl6Qk9WRUV5VDFSUk0wMVVVWEZTTVVaTlMyNTRiRTVVU21sTk1sbDVXVzFKTWs5VWFHaE9ha0V6V2xSRk1WbHFTWGxhUkZwcFdWZEtiRmx0VFhoWmFtTXdUakpWTWxwRVVYZGFW…"
}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`, about 16 per page. Pass `cursor` from the answer back as `cursor` for the next page; it is null on the last page. An unknown board is a free 404; a board with no pins returns 200 with an empty list for 0 credits. A cursor that is not from a previous answer 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.