Skip to main content
Agents are the core building blocks of the Mindcase API. Each agent scrapes a specific type of data from a specific platform. Agents are organized into groups by platform.

​
How Agents Work

  1. Discover — Browse agents by group or get details for a specific agent
  2. Run — Submit a job with the agent’s required parameters
  3. Poll — Check job status until complete
  4. Retrieve — Download structured data as JSON

​
List All Agent Groups

curl https://api.mindcase.co/api/v1/agents \
  -H "Authorization: Bearer mk_live_abc123def456"
Response
{
  "groups": [
    "instagram",
    "linkedin",
    "youtube",
    "twitter",
    "tiktok",
    "amazon",
    "google-maps",
    "shopify",
    "reddit",
    "indeed",
    "app-store",
    "flipkart",
    "myntra",
    "tools"
  ]
}

​
List Agents in a Group

curl https://api.mindcase.co/api/v1/agents/instagram \
  -H "Authorization: Bearer mk_live_abc123def456"
Response
{
  "agents": [
    {
      "slug": "profile-scraper",
      "name": "Instagram Profile Scraper",
      "description": "Extracts public Instagram profile metadata...",
      "credits_per_row": 1
    },
    {
      "slug": "post-scraper",
      "name": "Instagram Post Scraper",
      "description": "Extracts comprehensive post-level metadata...",
      "credits_per_row": 1
    }
  ]
}

​
Get Agent Details

curl https://api.mindcase.co/api/v1/agents/instagram/profile-scraper \
  -H "Authorization: Bearer mk_live_abc123def456"
Response
{
  "group": "instagram",
  "slug": "profile-scraper",
  "name": "Instagram Profile Scraper",
  "description": "Extracts public Instagram profile metadata...",
  "credits_per_row": 1,
  "parameters": {
    "usernames": {
      "type": "array",
      "required": true,
      "description": "Array of Instagram usernames without '@'."
    }
  }
}

​
Available Platforms

Instagram

Profiles, posts, comments

LinkedIn

Profiles, companies, jobs, employees

YouTube

Channels, videos, comments, Shorts

Twitter / X

Tweets with advanced filters

TikTok

User profiles and stats

Amazon

Products, reviews, bestsellers

Google Maps

Businesses, reviews, geocoding

Shopify

Product data from any store

Reddit

Posts, comments, communities

Indeed

Job listings worldwide

App Store

App reviews by country

Flipkart

Indian e-commerce products

Myntra

Fashion product listings

Tools

Pricing data, VC data, matching