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.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
The hashtag to search for. The leading # is optional.
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"
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.
When true, returns URL-safe media links suitable for embedding.
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.
0 <= valueKeep 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.
1 <= value <= 3650views: return the kept rows ordered by view count, highest first, across every page walked. Rows without a view count go last.
Value in
- "views"
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.
1 <= value <= 5An 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}Reels › Trending GET
Returns reels from Instagram's public trending page, each with shortcode, URL, caption, media URLs, engagement counts where shown, and the account. Use it to sample global trends; it takes no region. Call again to see more. For one region, page location/posts after search/location. **100 credits** per call. Re-running the exact same call within 1h is free.
Search › Location GET
Returns places matching a keyword, each with its location id, name, and coordinates, plus a display title and subtitle. Use it to turn a place name into a location id, then pass that id to location/posts to see what was posted there. **100 credits** per call. Re-running the exact same call within 1h is free.