Getting Started

The Mindcase Developer API gives you programmatic access to 100 data collection agents across Instagram, LinkedIn, YouTube, Amazon, Google, and 31 other platforms. Each agent handles the complexity of data extraction, you just pass parameters and get back clean, structured data.

It’s a straightforward REST API. Use cURL, your language’s HTTP client, or any tool that can speak HTTP, no SDK required.

Authentication

Every API request requires an API key. You can get one by signing up at mindcase.co, every account is auto-issued exactly one key, visible in your Settings.

API keys start with mk_live_ and are passed as a Bearer token in the Authorization header:

Authorization: Bearer mk_live_your_api_key_here

Keep your API key secret. Do not commit it to version control or expose it in client-side code. Use environment variables in production.

Base URL

All requests use this base URL:

https://api.mindcase.co/api/v1

How It Works

Mindcase follows a simple run → poll → results pattern:

1. Run an agent

   Pick an agent (e.g., instagram/profiles) and pass your parameters. The API queues a job and returns a job_id immediately.

2. Wait for completion

   The job runs in the background. Poll the status endpoint until it reports completed.

3. Get your data

   Fetch the results, clean, structured data as an array of rows. Each row is a JSON object with the fields relevant to that agent.

Quick Start

Here’s a complete flow, run an Instagram Profiles agent, wait for results, and process the data:

curl

# 1. Start the agent
curl -X POST https://api.mindcase.co/api/v1/agents/instagram/profiles/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{"params": {"usernames": ["nike", "adidas"]}}'
# → {"job_id": "job_abc123", "status": "queued"}

# 2. Poll for status (repeat until status is "completed")
curl https://api.mindcase.co/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer mk_live_abc123def456"
# → {"status": "completed", "row_count": 2}

# 3. Get results
curl https://api.mindcase.co/api/v1/jobs/job_abc123/results \
  -H "Authorization: Bearer mk_live_abc123def456"
# → {"data": [{"username": "nike", "followersCount": 306000000, ...}]}

More Examples

Scrape Google Maps places

Find local places by keyword and location. Returns ratings, reviews, addresses, and contact info.

curl

curl -X POST https://api.mindcase.co/api/v1/agents/google/maps/places/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "keywords": ["coffee shops"],
      "location": "San Francisco, United States",
      "maxResults": 20
    }
  }'

Search LinkedIn companies

Search LinkedIn for companies by keyword, industry, or location. Returns names, descriptions, employee counts, and more.

curl

curl -X POST https://api.mindcase.co/api/v1/agents/linkedin/company-search/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "search": "AI startup",
      "maxItems": 10,
      "locations": ["San Francisco"]
    }
  }'

Pricing

Every agent has a per-1k-row price visible on its individual reference page (e.g., linkedin/profiles → $3.5 / 1k profiles). When you run an agent, you’re charged based on the number of rows returned. Check your balance:

curl https://api.mindcase.co/api/v1/balance \
  -H "Authorization: Bearer mk_live_abc123def456"
# → {"usd_remaining": 8.50}

Browse per-agent prices in the Agents Overview.

Rate Limits

The API allows up to 60 requests per minute per API key. If you exceed this limit, you’ll receive a 429 Too Many Requests response.

What’s Next?

Agents Overview

Browse all 100 agents with parameters, pricing, and example use cases.

Jobs API

Submit jobs, poll status, and retrieve results.