Crawlzodocs
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 visible only to the account that owns a post. No public surface carries them, so we never populate them.

The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 4.6s.

POST
/v1/scrapers/instagram-search-v4

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  }}