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

# Instagram Profiles API

> Extract Instagram account data (bio, followers, verification, business info, links, and recent posts) by username or keyword search

`POST /v1/data/instagram/profiles/run`

**Pricing:** $0.002 per profile ($2.00 per 1,000).

Look up specific accounts by username or URL, or search Instagram accounts by keyword.

## Ways to call it

* **Handle**: set `usernames`
* **Search**: set `query` (optional: `maxResults`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**usernames** `string[]`

Instagram usernames (e.g. natgeo, shopify) or full profile URLs (e.g. [https://www.instagram.com/natgeo/](https://www.instagram.com/natgeo/)) to look up.

**query** `string`

Keyword to search Instagram accounts by (e.g. coffee, nasa).

**maxResults** `integer`

Number of profiles to return. Use 0 for all. Capped at 250.

Max `250`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/instagram/profiles/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "usernames": [
      "nike",
      "neymarjr",
      "natgeo"
    ]
  }
}'
```

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

r = requests.post(
    "https://api.mindcase.co/v1/data/instagram/profiles/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "usernames": [
        "nike",
        "neymarjr",
        "natgeo"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/instagram/profiles/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "usernames": [
    "nike",
    "neymarjr",
    "natgeo"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one profile, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `profileUrl` | Profile URL | url |
| `instagramId` | Instagram ID | text |
| `username` | Username | text |
| `fullName` | Full Name | text |
| `bio` | Bio | text |
| `followers` | Followers | number |
| `following` | Following | number |
| `posts` | Posts | number |
| `verified` | Verified | boolean |
| `private` | Private | boolean |
| `businessAccount` | Business Account | boolean |
| `businessCategory` | Business Category | text |
| `businessStreet` | Business Street | text |
| `businessCity` | Business City | text |
| `businessZip` | Business Zip | text |
| `businessLatitude` | Business Latitude | number |
| `businessLongitude` | Business Longitude | number |
| `businessCityId` | Business City ID | text |
| `bioLinks` | Bio Links | object\_array |
| `profilePicture` | Profile Picture | url |
| `highlightReels` | Highlight Reels | number |
| `lastPostDate` | Last Post Date | text |
| `recentPosts` | Recent Posts | object\_array |
| `relatedAccounts` | Related Accounts | object\_array |
| `facebookPage` | Facebook Page | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "instagram/profiles",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "businessCategory": null,
      "bioLinks": [
        {
          "title": "🏨 Save up to 40% on your next hotel in the USA",
          "url": "https://athotel.us/USA-hotel-deals"
        },
        {
          "title": "🇺🇸 Best car rental deals across the USA",
          "url": "https://athotel.us/autorentals-USA"
        }
      ],
      "businessZip": null,
      "private": false,
      "businessCity": null,
      "lastPostDate": "2026-08-16T21:00:22.000Z",
      "followers": 945537,
      "businessAccount": false,
      "recentPosts": [
        {
          "postUrl": "https://www.instagram.com/p/DbYe5U0CMt4/",
          "type": "Sidecar",
          "imageUrl": "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/757755055_18617273536063378_4647907364098801830_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in...",
          "videoUrl": null,
          "images": [
            "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/757755055_18617273536063378_4647907364098801830_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in...",
            "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/756612677_18617273554063378_5487877644593788428_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in...",
            "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/757480262_18617273569063378_1715684804820583983_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in..."
          ],
          "caption": "New York ranked among the world’s five best cities for 2026.\n\n💡 What to Know:\n1️⃣ Time Out ranked New York City #5 in its 2026 list of the world’s best citie...",
          "date": "2026-07-29T15:54:05.000Z",
          "likes": 6886,
          "comments": 658,
          "videoViews": null,
          "pinned": true
        },
        {
          "postUrl": "https://www.instagram.com/p/DbDvHxviNpa/",
          "type": "Sidecar",
          "imageUrl": "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/753206448_18614799283063378_8710526263887817171_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in...",
          "videoUrl": null,
          "images": [
            "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/753206448_18614799283063378_8710526263887817171_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in...",
            "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/753092380_18614799274063378_3069872801855432182_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in...",
            "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.82787-15/751819132_18614799292063378_8077874805656455992_n.heic?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=in..."
          ],
          "caption": "The World Cup record America set in 1994 finally fell, 32 years later.🇺🇸⚽\n\n1️⃣ USA 1994: 3,404,252 spectators attended, setting a record that lasted more tha...",
          "date": "2026-07-21T14:31:49.000Z",
          "likes": 2115,
          "comments": 144,
          "videoViews": null,
          "pinned": true
        }
      ],
      "relatedAccounts": [
        {
          "username": "italyexplores",
          "name": "Italy 🇮🇹 Italia Travel | Hotels | Food | Tips",
          "url": "https://www.instagram.com/italyexplores/",
          "verified": true,
          "private": false
        },
        {
          "username": "canada.explores",
          "name": "Canada 🇨🇦 Travel | Hotels | Food | Tips 🍁",
          "url": "https://www.instagram.com/canada.explores/",
          "verified": true,
          "private": false
        }
      ],
      "bio": "🇺🇸 From coast to coast\n📍 Exploring the cities nature & culture of the USA\n👇 Get up to 40% off hotels in the USA",
      "profileUrl": "https://www.instagram.com/usa.explores",
      "profilePicture": "https://instagram.fqsr1-1.fna.fbcdn.net/v/t51.2885-19/410524444_670955768491466_6863273888175321052_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6In...",
      "username": "usa.explores",
      "businessLatitude": null,
      "businessLongitude": null,
      "fullName": "USA 🇺🇸 Travel | Hotels | Food | Tips",
      "following": 1049,
      "businessCityId": null,
      "highlightReels": 8,
      "verified": true,
      "businessStreet": null,
      "facebookPage": null,
      "instagramId": "1327615377",
      "posts": 22562
    }
  ]
}
```

## Related APIs

For a profile's posts and reels use [`instagram/posts`](https://docs.mindcase.co/apis/instagram/posts); for its follower list use [`instagram/followers`](https://docs.mindcase.co/apis/instagram/followers).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.