Skip to main content

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.

$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

​
query
array
required
List · Search keywords. One per line.
​
searchType
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
​
maxResults
integer
default:50
Number · Maximum results per search term (hashtags, users, or places). Use 0 for all.

​
Response columns

FieldDisplay nameType
profileUrlProfile URLurl
usernameUsernametext
fullNameFull Nametext
bioBiotext
verifiedVerifiedboolean
businessAccountBusiness Accountboolean
businessCategoryBusiness Categorytext
privatePrivateboolean
joinedRecentlyJoined Recentlyboolean
followersFollowersnumber
followingFollowingnumber
postsPostsnumber
igtvCountIGTV Countnumber
highlightReelsHighlight Reelsnumber
profilePictureProfile Pictureurl
profilePictureHdProfile Picture HDurl
externalUrlsExternal URLsarray
latestPostsLatest Postsarray
latestIgtvVideosLatest IGTV Videosarray
relatedProfilesRelated Profilesarray
threadsProfileThreads Profileobject

​
Example

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
  }
}'

​
Example response

Response
{
  "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"
      }
    }
  ]
}