Skip to main content
The Mindcase Developer API gives you programmatic access to 30+ data scraping agents across Instagram, LinkedIn, YouTube, Amazon, Google Maps, and more. Run agents, poll for results, and download structured data — all via REST.

​
Base URL

All API requests use this base URL: 
https://api.mindcase.co/api/v1

​
Authentication

Every request requires a Bearer token. API keys start with mk_live_ and can be created from Settings > Developer in the Mindcase dashboard. 
curl https://api.mindcase.co/api/v1/credits \
  -H "Authorization: Bearer mk_live_abc123def456"

​
Quick Example

Here’s a complete flow — run an Instagram Profile Scraper, poll for status, then fetch results: 
# 1. Start the agent
curl -X POST https://api.mindcase.co/api/v1/agents/instagram/profile-scraper/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{"params": {"usernames": ["nike", "adidas"]}}'

# Response: {"job_id": "job_abc123", "status": "queued"}

# 2. Poll for status
curl https://api.mindcase.co/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer mk_live_abc123def456"

# Response: {"status": "completed", "row_count": 2, "credits_used": 2}

# 3. Get results
curl https://api.mindcase.co/api/v1/jobs/job_abc123/results \
  -H "Authorization: Bearer mk_live_abc123def456"

# Response: {"data": [{"username": "nike", "followersCount": 306000000, ...}]}

​
Rate Limits

API keys are limited to 60 requests per minute. If you exceed this, you’ll receive a 429 status code. Wait and retry with exponential backoff.

​
Credits

Each agent consumes credits per row of data returned. Most agents cost 1 credit/row, while premium agents like LinkedIn Profile Scraper cost 2 credits/row. Check your balance anytime: 
curl https://api.mindcase.co/api/v1/credits \
  -H "Authorization: Bearer mk_live_abc123def456"

​
Error Codes

CodeMeaning
401Invalid or missing API key
402Insufficient credits
404Agent or job not found
422Invalid request parameters
429Rate limit exceeded (60 req/min)
500Internal server error

​
What’s Next?

Authentication

Learn how to create and manage API keys.

Agent Reference

Browse all 30+ available data agents.

Running Agents

Submit jobs and retrieve results.

Python SDK

Use our Python client library.