Instagram hashtag suggestions API

GET /v1/instagram/search

Instagram's own hashtag search for the words: the hashtags that start with them, in Instagram's order, about 50 in one page with no cursor. Each carries its id, url and post count (extra.post_count, and extra.post_count_label, the rounded label Instagram prints; small tags read 100+). An unusual word answers an empty list. Accounts, places and keyword suggestions are not in the answer. For a hashtag's posts use search/hashtag; for accounts search/profiles.

• Cost: 1 credit
• Cache: Results are kept up to 1 day; send max_age_days to reuse them for free.
• Timeout: A request still running after about 25 seconds answers 202 with a job to poll (Batch and jobs).

Parameters#

Every request also accepts:

• cursor: the cursor from the previous page (Pagination).
• trim: true for a smaller response without null fields and extra.
• raw: true to also get the platform's original object as raw.
• max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).

Example request#

Set your key in the environment first (see Authentication).

1curl -G "https://api.socialscrape.dev/v1/instagram/search" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3  --data-urlencode "query=nike"

1import os2import requests34params = {5    "query": "nike",6}7res = requests.get(8    "https://api.socialscrape.dev/v1/instagram/search",9    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10    params=params,11)12body = res.json()1314if body["ok"]:15    print(body["data"])16else:17    print(body["error"]["code"], body["error"]["message"])

1const url = new URL("https://api.socialscrape.dev/v1/instagram/search");2url.search = new URLSearchParams({3  "query": "nike"4}).toString();5const res = await fetch(url, {6  headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11  console.log(body.data);12} else {13  console.error(body.error.code, body.error.message);14}

1{2  "nodes": [3    {4      "name": "SocialScrape Instagram hashtag suggestions",5      "type": "n8n-nodes-base.httpRequest",6      "typeVersion": 4.2,7      "position": [8        0,9        010      ],11      "parameters": {12        "method": "GET",13        "url": "https://api.socialscrape.dev/v1/instagram/search",14        "sendQuery": true,15        "queryParameters": {16          "parameters": [17            {18              "name": "query",19              "value": "nike"20            }21          ]22        },23        "sendHeaders": true,24        "headerParameters": {25          "parameters": [26            {27              "name": "x-api-key",28              "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29            }30          ]31        }32      }33    }34  ],35  "connections": {}36}

Example response#

This is a sample from a recorded response, lists and long text are shortened. Status 200.

1{2  "ok": true,3  "credits_charged": 1,4  "credits_remaining": 4999,5  "cached": false,6  "cached_at": null,7  "request_id": "req_efc32063b603ee644b2b20e0",8  "data": {9    "object": "list",10    "items": [11      {12        "object": "suggestion",13        "platform": "instagram",14        "kind": "hashtag",15        "text": "nikewomen",16        "id": "17841562978125529",17        "handle": null,18        "url": "https://www.instagram.com/explore/tags/nikewomen/",19        "image_url": null,20        "verified": null,21        "extra": {22          "post_count": 2027008,23          "post_count_label": "2M"24        }25      },26      {27        "object": "suggestion",28        "platform": "instagram",29        "kind": "hashtag",30        "text": "nikeairmax",31        "id": "17841563764097648",32        "handle": null,33        "url": "https://www.instagram.com/explore/tags/nikeairmax/",34        "image_url": null,35        "verified": null,36        "extra": {37          "post_count": 4839167,38          "post_count_label": "4.8M"39        }40      }41    ],42    "cursor": null,43    "has_more": false,44    "parent": null45  },46  "cursor": null,47  "has_more": false48}

Response#

A list of Suggestion objects in data.items, with data.cursor and data.has_more.

See Data models for every field. The envelope around data is described in Responses.

Errors#

Failures are free: credits_charged is 0. Branch on error.code, never on the message.

Every request can also fail with the account and platform errors listed on the Errors page.

Related endpoints#

• Instagram profile (GET /v1/instagram/profile)
• Instagram profile by user id (GET /v1/instagram/basic-profile)
• Instagram profile post count (GET /v1/instagram/profile/post-count)
• Instagram profile posts (GET /v1/instagram/profile/posts)
• Instagram profile reels (GET /v1/instagram/profile/reels)
• Instagram post or reel details (GET /v1/instagram/post)
• Instagram reel transcript (GET /v1/instagram/post/transcript)
• Instagram post comments (GET /v1/instagram/post/comments)