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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Instagram usernames (e.g. natgeo, shopify) or full profile URLs (e.g. https://www.instagram.com/natgeo/) to look up.
Example
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"
]
}
}'
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
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 indata 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.{
"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 useinstagram/posts; for its follower list use instagram/followers.