İçeriğe geç

Popüler Arama

GET/v1/instagram/search/popular1 kredi

Instagram'ın bir anahtar kelime için gösterdiği popüler gönderileri, konunun kısa açıklaması ve ilgili arama terimleriyle birlikte döndürür.

01Sorgu parametreleri

AdTürAçıklama
queryzorunlustringAnahtar kelime ya da konu, örneğin `nature`.
cursoristeğe bağlıstringSonraki sayfanın cursor'ı: bir önceki yanıttaki `cursor` değeri.

02İstek

curl "https://api.scrapesocial.ai/v1/instagram/search/popular?query=nature" \
  -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/search/popular?query=nature

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "query": "nature",
  "title": "Nature",
  "total_media_count": null,
  "description": {
    "plain_text": "Nature 🌍 (fantastic.life), a nature-focused page with 300k followers, shares content about planet life and conservation. Recent posts highlight forest ecosystems and calming nature visuals meant to connect people with the outdoors and promote wellbeing.\\n\\nThe account focuses on themes like biodiversity and the healing power of nature. Research shows environments with diverse bird and tree species…",
    "source_uris": [
      "https://thefantasticlife.com/2026/04/20/the-healing-power-of-nature/",
      "https://nftcollectorshub.co.uk/press-release/2026-04-15/31642/exploring-nature-s-wonders-a-journey-into-the-backyard-ecosystem"
    ],
    "linked_terms": []
  },
  "suggested_terms": [
    "green nature aesthetic quotes",
    "natural nails ideas"
  ],
  "posts": [
    {
      "id": "POLARIS_3865503563578017023",
      "shortcode": "DWlBwLBEwT_",
      "url": "https://www.instagram.com/reel/DWlBwLBEwT_/",
      "type": "reel",
      "caption": "Just wait for it…\n\n#maldives #beach #island #nature",
      "display_url": "https://scontent-ber1-1.cdninstagram.com/v/t51.71878-15/657256222_1270746537884597_1117066132636706266_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=vgPYHCgPE7EQ7kNvwE7EcAt&_nc_oc=AdpMUEti_uwTT1VyZLokCisMHzxRDS44Qlth8J5Yr9XC0rWOYHU2qI73pliPuOiZYphW_l5aLKLRALJ0lretBy3A&_nc_zt=23&_nc_ht=scontent-ber1-1.c…",
      "video_url": "https://scontent-ber1-1.cdninstagram.com/o1/v/t2/f2/m367/AQOzrdjHcRDOfF3PrlrGyvkLA5KQStPnPp5QI9X553XEz0-ykAvNDFTVmQ3f3NbLeMPJkdE17RskGjdESLRSElarO96dUeOYQaGVmb8.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-ber1-1.cdninstagram.com&_nc_ohc=JYZC1jDlVrcQ7kNvwHo6lod&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgxNjQyMTM3…",
      "play_count": 155484285,
      "owner": {
        "id": "17841412593441479",
        "username": "peterliappas",
        "is_verified": true,
        "profile_pic_url": "https://scontent-ber1-1.cdninstagram.com/v/t51.2885-19/316452441_158094350256506_4568802957558273493_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=104&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy45ODkuQzMifQ%3D%3D&_nc_ohc=2tPejpo0qfoQ7kNvwEFdjJO&_nc_oc=Adpbua04cXesnc8iDduWQoXd1CfzMXXB-SXTYBDmTigLqAuj87357ois5HM-JDbU-exXrhYK3Fx9wsuHPH5t1-X_&_nc_zt=24&_nc_ht=scontent-ber1-1.cdninst…"
      }
    },
    {
      "id": "POLARIS_3841441307600830292",
      "shortcode": "DVPioQ1Dz9U",
      "url": "https://www.instagram.com/reel/DVPioQ1Dz9U/",
      "type": "reel",
      "caption": "Waiting for the a monsoon in Kerala\n\n#monsoon #sukoon #nature #peace",
      "display_url": "https://scontent-ber1-1.cdninstagram.com/v/t51.71878-15/639753776_1635519347580374_8319993174093551804_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=yN-0t8S9BxQQ7kNvwFAzqWq&_nc_oc=AdqCKPCJLg3elvurKKD99-9oDMuN02Up068yyRjIg_HxQyV29ry-RsTo9o8InaEUK2753KlhzoqvyIUfmpiMsb7y&_nc_zt=23&_nc_ht=scontent-ber1-1.c…",
      "video_url": "https://scontent-ber1-1.cdninstagram.com/o1/v/t16/f2/m69/AQNhPgaGMQVyUxIKqV2MAy6SAYWvbcap3WvFg_dfMKcHNY0D9OLDFCmR6dar_fMTM2vjFJSbzmVcx3EDoBoX_6qr.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-ber1-1.cdninstagram.com&_nc_ohc=ynrbI8OEW0AQ7kNvwE1NPzd&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc5NDkwMDI4MjMxMD…",
      "play_count": 151818432,
      "owner": {
        "id": "17841401981541912",
        "username": "anoopchandran006",
        "is_verified": true,
        "profile_pic_url": "https://scontent-ber1-1.cdninstagram.com/v/t51.2885-19/353339922_6502009516580834_662673632171346305_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=2Wx9UViyo28Q7kNvwF2zhb5&_nc_oc=AdqQ74yE92ypkN_rlb1XDL14KcgZ97ge18iufsX_Y9aDjXMeQoAM0g3n5o10FaM6FKp5_dliZL7ZtCIX04OjJdtR&_nc_zt=24&_nc_ht=scontent-ber1-1.cdninstagra…"
      }
    }
  ],
  "cursor": "eyJ2ZXJzaW9uIjoxLCJxdWVyeSI6Im5hdHVyZSIsImFmdGVyIjoiQVFIVFVTRmxUemN2UnlWVk5Qd3Q0SE9WNno0SkxMZUUwbl9VaXdYRlNtYzNuNE9NaHBZWEZ0aVJKbE00dmdMNWdVWnEiLCJsc2QiOiJBZFRtWW1nVElZRFpiSlZUQ0ttQ2daejVhaGsiLCJjc3JmVG9rZW4iOiJsdE05QUNjb0lPbzlTTmdQYjBMQzFJIn0",
  "has_more": true
}

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

Her sayfada `posts` içinde 12 gönderi ile birlikte `title`, `description`, `total_media_count` ve `suggested_terms` alanları gelir. `has_more` true olduğu sürece `cursor` değerini geri gönderin. Gönderisi olmayan anahtar kelime 0 kredilik boş liste döner.

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.