API referenceInstagram
Instagram search
Instagram-native ranked accounts, hashtags and suggested terms for a keyword.
Instagram publishes a post's view count only for video. Photo and carousel posts return null rather than zero, because zero would be a claim we cannot support.
Share and save counts are not public on Instagram, so they are not returned.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/instagram-search-v4" \ -H "Content-Type: application/json" \ -d '{ "query": "cars" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "hashtags": [ { "name": "cars", "post_matches": 16, "url": "https://www.instagram.com/explore/tags/cars/" }, { "name": "fyp", "post_matches": 3, "url": "https://www.instagram.com/explore/tags/fyp/" }, "… 101 more items in the full response" ], "keywords": [ "cars memes pixar", "car bow ribbon", "… 8 more items in the full response" ], "places": [], "query": "cars", "rank_token": null, "users": [ { "full_name": null, "is_private": null, "is_verified": true, "pk": "17841459401872912", "profile_pic_url": "https://scontent-lga3-1.cdninstagram.com/v/t51.82787-19/626667495_17977952783980063_4603710452593790065_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=109&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy43MjAuQzIifQ%3D%3D&_nc_ohc=UMpdFfbDmkoQ7kNvwF35odg&_nc_oc=AdprJNh2z7XpZc7e3LCcIZYzlIQQAdJSpmdRK0d8QUX6MO… (+180 chars)", "url": "https://www.instagram.com/desharpen/", "username": "desharpen" }, { "full_name": null, "is_private": null, "is_verified": true, "pk": "17841445413912805", "profile_pic_url": "https://scontent-lga3-2.cdninstagram.com/v/t51.75761-19/499261159_18062970146513798_720618000934786052_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=101&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMyIn0%3D&_nc_ohc=dePkebu9lo4Q7kNvwFvHIm7&_nc_oc=Ado0tUkv36dw8jRMCMuYU8LWeFUT0dRsTSiXGkZKmQjSmmE01… (+177 chars)", "url": "https://www.instagram.com/preisngr/", "username": "preisngr" }, "… 20 more items in the full response" ] }, "success": true }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "instagram-search-v4", "billable": true, "duration_ms": 3891 }}