İçeriğe geç

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

AdTürAçıklama
urlzorunlustringPanonun URL'si, örneğin `https://www.pinterest.com/lizmrodgers/moms-night/`.
cursoristeğe bağlıstringBir ö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.