Popular Search

GET/v1/instagram/search/popular1 credit

Returns the popular posts Instagram shows for a keyword, along with a short description of the topic and related search terms.

01Query parameters

Name	Type	Description
queryrequired	string	Keyword or topic, e.g. `nature`.
cursoroptional	string	Cursor for the next page: the `cursor` value of the previous answer.

02Request

curl "https://api.scrapesocial.ai/v1/instagram/search/popular?query=nature" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

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
}

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

12 posts per page in `posts`, plus `title`, `description`, `total_media_count` and `suggested_terms`. Pass `cursor` back while `has_more` is true. A keyword with no posts is an empty list for 0 credits.

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.