Quickstart

### Get an API key

Sign in at [keirolabs.cloud](https://platform.keirolabs.cloud/dashboard), open **API Keys** and create a key. It starts with `keiro_` and is shown once, so copy it now.

```bash
export KEIRO_API_KEY="keiro_..."
```

### Make a request

**cURL**

```bash
curl -X POST https://api.keirolabs.cloud/api/v2/search/google \
  -H "Authorization: Bearer $KEIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best vector databases 2026"}'
```

**Python**

```python
import os, requests

res = requests.post(
    "https://api.keirolabs.cloud/api/v2/search/google",
    headers={"Authorization": f"Bearer {os.environ['KEIRO_API_KEY']}"},
    json={"query": "best vector databases 2026"},
)
print(res.json())
```

**Node.js**

```js
const res = await fetch("https://api.keirolabs.cloud/api/v2/search/google", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KEIRO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "best vector databases 2026" }),
});
console.log(await res.json());
```

### Read the response

```json
{
  "query": "best vector databases 2026",
  "results": [
    { "title": "...", "url": "https://...", "snippet": "..." }
  ],
  "count": 10,
  "latencyMs": 240,
  "creditsCharged": 2,
  "creditsRemaining": 11248
}
```

Every response tells you what it cost and what you have left.

## Next

  - [Get page content too](/content/search-content): Search and scrape the top results in one call.
  - [Let your agent do it](/mcp): Install Keiro MCP and your agent picks the right endpoint.