Pano
GET/v1/pinterest/board1 kredi
Herkese açık bir panoya kaydedilmiş pin'leri sayfa sayfa döndürür; her pin'in başlığı, açıklaması, görselleri, bağlantısı, pin'leyen kişi ve repin sayısı yer alır.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| urlzorunlu | string | Panonun URL'si, örneğin `https://www.pinterest.com/lizmrodgers/moms-night/`. |
| cursoristeğe bağlı | string | Bir önceki sayfanın `cursor` değeri; sonraki sayfayı almak için olduğu gibi geri gönderilir. |
| trimisteğe bağlı | boolean | `true` verilirse daha az alan içeren kısaltılmış bir nesne döner. Fiyat değişmez.Varsayılan: false |
02İstek
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"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
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…"
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notlar
Pin'ler `pins` içinde, sayfa başına yaklaşık 16 adet gelir. Sonraki sayfa için yanıttaki `cursor` değerini `cursor` parametresiyle geri gönderin; son sayfada null olur. Bulunamayan bir pano ücretsiz bir 404 döndürür; pin'i olmayan bir pano için 200 ve boş bir liste döner, 0 kredi düşer. Önceki bir yanıttan gelmeyen bir cursor ücretsiz bir 400 hatası verir.
05Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.