GETSearch1 credit
Search users
GET https://api.instagramapi.dev/v1/search/usersReturns accounts matching a search query, ranked by Instagram relevance.
Build this with an AI agent
Paste this prompt into Claude, Codex, or any coding agent.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | yes | Search text. |
Example request
curl "https://api.instagramapi.dev/v1/search/users?q=coffee" \
-H "Authorization: Bearer $INSTAGRAMAPI_KEY"Try it
Live request · uses 1 creditExample responses
Switch tabs to see the body shape for success and each error status.
{
"data": {
"items": [
{
"id": "41238621959",
"username": "ddetoddo",
"full_name": "TODDO ★ Coffee & Food",
"is_verified": false,
"is_private": false,
"profile_pic_url": "https://instagram.com/.../toddo.jpg"
}
],
"next_cursor": null
},
"meta": {
"endpoint": "search/users",
"request_id": "req_3f8a1c9e",
"credits_charged": 1,
"credits_remaining": 4987,
"ms": 412
}
}Response fields
Fields returned under data on a 200 response. Every response also includes a meta object with billing info.
| Field | Type | Description |
|---|---|---|
| items | array<object> | Matching accounts, ranked by Instagram relevance. |
| items[].id | string | Numeric account id (stable even if the username changes). |
| items[].username | string | The account's @handle. |
| items[].full_name | string | Display name shown on the profile (may be empty). |
| items[].is_verified | boolean | Whether the account has a verified badge. |
| items[].is_private | boolean | Whether the account is private. |
| items[].profile_pic_url | string | URL of the account's profile picture. |
| next_cursor | null | Always null. This endpoint returns a single page and isn't paginated. |