> ## 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.

# Quickstart

> Get an API key and run your first Mindcase API.

**1. Get an API key**

Sign up at [console.mindcase.co](https://console.mindcase.co) and copy your key from the console. Keys start with `mk_live_`. Add balance to your wallet before your first run.

```bash theme={null}
export MINDCASE_API_KEY="mk_live_..."
```

**2. Run an API**

This finds coffee shops in San Francisco with the [Google Maps Places](https://docs.mindcase.co/apis/google-maps/places.md) API. `?wait=true` holds the request open until the rows are ready (up to 60 seconds).

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/google-maps/places/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params": {"keywords": "coffee", "location": "San Francisco, USA", "maxResults": 20}}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/google-maps/places/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {"keywords": "coffee", "location": "San Francisco, USA", "maxResults": 20}},
)
print(r.json()["data"][:2])
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/google-maps/places/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    params: { keywords: "coffee", location: "San Francisco, USA", maxResults: 20 },
  }),
});
console.log((await r.json()).data.slice(0, 2));
```

**3. Read the rows**

The response carries the rows in `data`, plus the job's status and what it cost.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "google-maps/places",
  "status": "completed",
  "row_count": 20,
  "returned": 20,
  "truncated": false,
  "data": [
    { "businessName": "Sightglass Coffee", "rating": 4.6, "reviews": 2113, "address": "..." }
  ]
}
```

## Next steps

> [card] [Find the right API](https://docs.mindcase.co/apis/overview.md)
>
> 249 APIs, grouped by platform, with price per row.

> [card] [Long and large runs](https://docs.mindcase.co/running-apis.md)
>
> Polling, idempotent retries and downloading big result sets.

> [card] [Handle errors](https://docs.mindcase.co/errors.md)
>
> Error codes, the `retryable` flag and when to try again.

> [card] [Use it from an agent](https://docs.mindcase.co/mcp.md)
>
> Connect the MCP server to Claude, ChatGPT or Cursor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.