> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram Profile Search

> Extract Instagram profiles, places, and hashtags from a search query, listing names, follower counts, and post details

`$1.4 / 1k profiles`

Extract Instagram profiles, places, and hashtags from a search query, listing names, follower counts, and post details

## Endpoint

`POST /api/v1/agents/instagram/search/run`

## Parameters

<ParamField body="query" type="array" required>
  **List** · Search keywords. One per line.
</ParamField>

<ParamField body="searchType" type="string" default="place">
  **Dropdown** · Choose the type of Instagram pages to search for (you can look for hashtags, profiles or places).

  **Options:** `place`, `user`, `hashtag`
</ParamField>

<ParamField body="maxResults" type="integer" default={50}>
  **Number** · Maximum results per search term (hashtags, users, or places). Use 0 for all.
</ParamField>

## Response columns

| Field              | Display name       | Type    |
| ------------------ | ------------------ | ------- |
| `profileUrl`       | Profile URL        | url     |
| `username`         | Username           | text    |
| `fullName`         | Full Name          | text    |
| `bio`              | Bio                | text    |
| `verified`         | Verified           | boolean |
| `businessAccount`  | Business Account   | boolean |
| `businessCategory` | Business Category  | text    |
| `private`          | Private            | boolean |
| `joinedRecently`   | Joined Recently    | boolean |
| `followers`        | Followers          | number  |
| `following`        | Following          | number  |
| `posts`            | Posts              | number  |
| `igtvCount`        | IGTV Count         | number  |
| `highlightReels`   | Highlight Reels    | number  |
| `profilePicture`   | Profile Picture    | url     |
| `profilePictureHd` | Profile Picture HD | url     |
| `externalUrls`     | External URLs      | array   |
| `latestPosts`      | Latest Posts       | array   |
| `latestIgtvVideos` | Latest IGTV Videos | array   |
| `relatedProfiles`  | Related Profiles   | array   |
| `threadsProfile`   | Threads Profile    | object  |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/instagram/search/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "query": [
        "Cristiano Ronaldo"
      ],
      "searchType": "user",
      "maxResults": 10
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/instagram/search/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "query": [
          "Cristiano Ronaldo"
      ],
      "searchType": "user",
      "maxResults": 10
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "profileUrl": "https://www.instagram.com/lu_ka2.13",
      "username": "lu_ka2.13",
      "fullName": "Cristiano Ronaldo.",
      "bio": "\u5065\u8eab\u5de5\u5ee0 \u4e09\u91cd\u5ee0 Luka\n\u589e\u808c\u6e1b\u8102 \u9ad4\u614b\u6539\u9020 \u52d5\u4f5c\u512a\u5316\u2600\ufe0f\n\u6559\u7df4\u8ab2\u7a0b\u6b61\u8fce\u79c1\u8a0a\nFocus on yourself  Not others\n\u904b\u52d5\u6309\u6469\u8d0a\u52a9 @soothe_see.sm\n\u6298\u6263\u78bc\u3010 Luka213 \u301195\u6298",
      "verified": false,
      "businessAccount": false,
      "businessCategory": null,
      "private": true,
      "joinedRecently": false,
      "followers": 736,
      "following": 527,
      "posts": 1,
      "igtvCount": 0,
      "highlightReels": 0,
      "profilePicture": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-19/656243498_18570857773015035_7482872464350444405_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2gHVGI4uK_cdDyE5n1Tp5z94xxXE2iOw55M34wjcunkOqv-CEQxwU7-VhINKf3o5GNs&_nc_ohc=U6i-YPGQGoIQ7kNvwHw25C7&_nc_gid=QquyRxuLzkTRqXyFxewFnA&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Af5oPUtdU-OpnvEekqg4a5LzwoxXiU__c8VTYvDyKCsWLg&oe=69FB7007&_nc_sid=8b3546",
      "profilePictureHd": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-19/656243498_18570857773015035_7482872464350444405_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2gHVGI4uK_cdDyE5n1Tp5z94xxXE2iOw55M34wjcunkOqv-CEQxwU7-VhINKf3o5GNs&_nc_ohc=U6i-YPGQGoIQ7kNvwHw25C7&_nc_gid=QquyRxuLzkTRqXyFxewFnA&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Af7J_MZZCZKQmeHiMNLQzjjKqIy3Xfp-BYU1HElsdCaIbg&oe=69FB7007&_nc_sid=8b3546",
      "externalUrls": [],
      "latestPosts": [],
      "latestIgtvVideos": [],
      "relatedProfiles": [],
      "threadsProfile": {
        "username": "lu_ka2.13",
        "pk": "63385782084",
        "hasOnboardedToTextPostApp": true,
        "text_post_app_is_private": false,
        "is_verified": null,
        "friendship_status": null,
        "follower_count": null,
        "profile_context_facepile_users": null,
        "full_name": "Cristiano Ronaldo.",
        "has_onboarded_to_text_post_app": true,
        "profile_pic_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.2885-19/484327711_670370142018621_1943193979979183755_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44MzIuYzIifQ&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2gGGdvM0pG5V3GW_x_OuFrOrqNTzcwbRpQlBTz3M-N0wBb0bTlOpTUvj84YpW1bQbTqNY3vV9mYueXIG8al-AfRA&_nc_ohc=RqI406hZv68Q7kNvwG0DhJB&_nc_gid=sHMCqQs3w_AuxP3r78BODw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Af6x1_JJ5MgSxdUKiuUPg-t9iQmRjT3cXHtZZD7mLahR1g&oe=69FB7EB6&_nc_sid=10d13b",
        "id": "63385782084"
      }
    }
  ]
}
```