Öne Çıkanlar

GET/v1/instagram/user/highlights1 kredi

Bir hesabın öne çıkan hikâyelerini id, başlık ve kapak görselleriyle listeler.

01Sorgu parametreleri

Ad	Tür	Açıklama
user_idisteğe bağlı	string	Sayısal Instagram kullanıcı id'si. `user_id` ya da `handle` parametrelerinden biri zorunludur. İkisi birlikte verilirse `handle` kullanılır.
handleisteğe bağlı	string	Instagram kullanıcı adı (başında `@` ya da profil URL'si de olabilir). `user_id` ya da `handle` parametrelerinden biri zorunludur.

02İstek

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

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/instagram/user/highlights?handle=instagram

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "highlights": [
    {
      "__typename": "GraphHighlightReel",
      "id": "18223279177302854",
      "cover_media": {
        "thumbnail_src": "https://scontent.cdninstagram.com/v/t51.71878-15/756700225_1653985762331725_8429300849500507026_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=NLBVWHHV_vYQ7kNvwGGHwEx&_nc_oc=Adr3uvS5WO6OWrlMO1Qc3iycVnoudR5bTJg4n_AEDPI9Y-Dkk2QSXDFJKux_stJvlv8&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=GYMcAKoGsz0FnwnRbre5Xw&_nc_ss=7b689&oh=00_AQOFtNfOMv67J7CwkLWiN4HTZzBmLB8O71S7-Q-L…"
      },
      "cover_media_cropped_thumbnail": {
        "url": "https://scontent.cdninstagram.com/v/t51.71878-15/756700225_1653985762331725_8429300849500507026_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=NLBVWHHV_vYQ7kNvwGGHwEx&_nc_oc=Adr3uvS5WO6OWrlMO1Qc3iycVnoudR5bTJg4n_AEDPI9Y-Dkk2QSXDFJKux_stJvlv8&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=GYMcAKoGsz0FnwnRbre5Xw&_nc_ss=7b689&oh=00_AQOFtNfOMv67J7CwkLWiN4HTZzBmLB8O71S7-Q-L…"
      },
      "owner": {
        "__typename": "GraphUser",
        "id": "25025320",
        "profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=HyKV99xb1PwQ7kNvwFIkHCV&_nc_oc=AdpqW7T_F0jW_XB4Je8jF0eWGWAqcsQpcPLykkxWpz9IzPVja1ImLWcMMlVBt_DZAaA&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=GYMcAKoGsz0FnwnRbr…",
        "username": "instagram"
      },
      "title": "close friends"
    },
    {
      "__typename": "GraphHighlightReel",
      "id": "18612622252018257",
      "cover_media": {
        "thumbnail_src": "https://scontent.cdninstagram.com/v/t51.71878-15/755867844_1751720619182762_5430881549273743299_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=SmUVvSate6sQ7kNvwHZgjzW&_nc_oc=Adp2fAk_7EmplsYCQydDVJqnz1SE8xPb0IseBEJmtER6NOWdetuMuaQXbo0ZoEiBA_4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=GYMcAKoGsz0FnwnRbre5Xw&_nc_ss=7b689&oh=00_AQOcQAmvIVXcX3aMDwNSbG4eBN6mTBtEDA_ogMiN…"
      },
      "cover_media_cropped_thumbnail": {
        "url": "https://scontent.cdninstagram.com/v/t51.71878-15/755867844_1751720619182762_5430881549273743299_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=SmUVvSate6sQ7kNvwHZgjzW&_nc_oc=Adp2fAk_7EmplsYCQydDVJqnz1SE8xPb0IseBEJmtER6NOWdetuMuaQXbo0ZoEiBA_4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=GYMcAKoGsz0FnwnRbre5Xw&_nc_ss=7b689&oh=00_AQOcQAmvIVXcX3aMDwNSbG4eBN6mTBtEDA_ogMiN…"
      },
      "owner": {
        "__typename": "GraphUser",
        "id": "25025320",
        "profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=HyKV99xb1PwQ7kNvwFIkHCV&_nc_oc=AdpqW7T_F0jW_XB4Je8jF0eWGWAqcsQpcPLykkxWpz9IzPVja1ImLWcMMlVBt_DZAaA&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=GYMcAKoGsz0FnwnRbr…",
        "username": "instagram"
      },
      "title": "🎤🎶🎸"
    }
  ]
}

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

Öne çıkanlar `highlights` içindedir; hikâyelerini almak için id'yi Öne Çıkan Detayı endpoint'inde kullanın. Kapak görseli küçük kare kırpılmış hâlidir. Öne çıkanı olmayan hesap 0 kredilik boş liste döner. Gizli ya da yaş sınırlı hesap ücretsiz 403, bulunamayan hesap ücretsiz 404 döner. Hiç reel paylaşmamış bir hesabın `user_id`'si çözümlenemez ve bulunamadı olarak yanıtlanır.

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.