GETSearch1 credit

Search users

GET https://api.instagramapi.dev/v1/search/users

Returns 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

NameTypeRequiredDescription
qstringyesSearch text.

Example request

curl "https://api.instagramapi.dev/v1/search/users?q=coffee" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

Try it

Live request · uses 1 credit

Example 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.

FieldTypeDescription
itemsarray<object>Matching accounts, ranked by Instagram relevance.
items[].idstringNumeric account id (stable even if the username changes).
items[].usernamestringThe account's @handle.
items[].full_namestringDisplay name shown on the profile (may be empty).
items[].is_verifiedbooleanWhether the account has a verified badge.
items[].is_privatebooleanWhether the account is private.
items[].profile_pic_urlstringURL of the account's profile picture.
next_cursornullAlways null. This endpoint returns a single page and isn't paginated.