InsightSocial API
Instagram

Search › Hashtag

GET
/v1/instagram/search/hashtag

Returns public posts carrying a hashtag, each with shortcode, URL, caption, media URLs, engagement counts, and the author; share and save counts are not included.

Use it to pull a hashtag feed; set type to top, recent, or clips to pick the ranking, and page deeper with the cursor it returns. Pass a result URL to post/stats for a share count.

100 credits per call.

Re-running the exact same call within 1h is free.

Paginates by cursor — see Pagination.

x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

hashtag*string

The hashtag to search for. The leading # is optional.

type?string

Ranking of the returned posts: top (default), recent, or clips (reels only). Only recent pages: top and clips are one ranked page each and return has_more: false.

Value in

  • "top"
  • "recent"
  • "clips"
cursor?string

Pagination cursor for type=recent only. Use the next_cursor from the previous response and send the same type again. top and clips return no cursor.

safe_url?boolean

When true, returns URL-safe media links suitable for embedding.

min_views?integer

Keep only rows with at least this many views (post.engagement.views). A row whose view count is unknown is discarded, so every returned row meets the floor. Filtering runs on our side after each page is fetched, so every page walked is billed as usual; data.walk.discarded counts what was removed and why.

Range0 <= value
max_age_days?integer

Keep only rows published within this many days (post.published_at), 1 to 3650. A row with no date is discarded. Filtering runs on our side after each page is fetched, so every page walked is billed as usual; data.walk.discarded counts what was removed and why.

Range1 <= value <= 3650
sort_rows?"views"

views: return the kept rows ordered by view count, highest first, across every page walked. Rows without a view count go last.

Value in

  • "views"
max_pages?integer

1 to 5 (default 1). Walk up to this many pages in one call and return the rows from all of them (after any filter). Each page walked is billed as one call to this endpoint; the whole walk counts once against your rate limit. The walk stops early at the last page, or when the request's time budget runs low; data.walk.stopped says why (end, max_pages, time_budget, page_error) and data.next_cursor continues from where it stopped.

Range1 <= value <= 5
seen?string

An id you choose (1 to 64 letters, digits, ., _ or -). Rows your account already received under the same seen id are removed from the page, and the page price falls with the share of repeats: page credits x new rows / rows on the page, rounded up, so a page of nothing but repeats is free. Use one id across a set of related searches; data.walk.repeats counts what was removed.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/instagram/search/hashtag?hashtag=string"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}