> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_instagram_users

# search_instagram_users

> Instagram accounts matching a keyword: handle, name, verification, private flag, picture; about fifty per call. ₹0.29 per call; no matches is ₹0.

## What it does

Instagram accounts whose name or handle matches `keyword`, in `data.items[]` (`data.count` says how many): `username`, `full_name`, `id`, `is_verified`, `is_private` and `profile_pic_url`, about fifty per call. Use it to find brands, creators or shops by name or theme, then [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md) for followers and bio and [`get_social_posts`](https://parel.si/docs/tools/get_social_posts.md) for what they post. It does not search captions or hashtags and gives no counts.

India: add a place or language to the keyword ("skincare india").

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `keyword` | string | yes | Search keyword. e.g. "instagram" |

## What drives the cost

Nothing: flat per call; no paging. No matches is `class: "ok_free"`, ₹0. Usually three to eight seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.29** per call (`cost_paise: 29`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.44 (`hold_paise: 44`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_instagram_users"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_instagram_users"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_instagram_users","input":{"keyword":"skincare india"}}'
```

## What comes back

`data.items[]` and `data.count`. A real answer recorded during the live check of 2026-10-28, trimmed to two accounts:

```json
{
  "count": 47,
  "items": [
    {
      "aigm_account_label_info": {
        "is_auto_detected": false,
        "is_enabled": false,
        "is_manually_enabled": false
      },
      "full_name": "Skincare_India",
      "has_anonymous_profile_picture": false,
      "id": "16505553774",
      "is_private": false,
      "is_ring_creator": false,
      "is_verified": false,
      "latest_reel_media": 0,
      "profile_pic_id": "2089778043884034333",
      "profile_pic_url": "https://scontent-cph2-1.cdninstagram.com/v/t51.2885-19/65686443_387319225223652_2169972552028389376_n.jpg",
      "show_ring_award": false,
      "unseen_count": 0,
      "username": "skin.careindia"
    },
    {
      "aigm_account_label_info": {
        "is_auto_detected": false,
        "is_enabled": false,
        "is_manually_enabled": false
      },
      "full_name": "SkinCareIndia",
      "has_anonymous_profile_picture": false,
      "id": "31222888170",
      "is_private": false,
      "is_ring_creator": false,
      "is_verified": false,
      "latest_reel_media": 0,
      "profile_pic_id": "2253737054450285598",
      "profile_pic_url": "https://scontent-cph2-1.cdninstagram.com/v/t51.2885-19/87543810_591096758142652_2808566946935603200_n.jpg",
      "show_ring_award": false,
      "unseen_count": 0,
      "username": "skin.care_india"
    },
    "… 45 more item(s) truncated"
  ]
}
```

## Notes

- About fifty accounts per call; no paging. No matches is free.
- Name and handle matches only; follower counts come from get_instagram_profile.
- Usually three to eight seconds.

## Siblings

- [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md) for the counts of each account.
- [`get_social_posts`](https://parel.si/docs/tools/get_social_posts.md) for their posts.
