# Documentation — API Quickstart

> Authenticate, call your first endpoint, read the envelope. Quickstart for the QuanticData scrape, SERP, map, crawl, batch and SEO audit APIs + MCP setup.

[Home](https://quanticdata.io/)/*Documentation*

# Documentation

Everything speaks one language: REST with a Bearer key and a single JSON envelope. This quickstart covers authentication, the endpoints, the envelope and the MCP setup — the per-product pages hold the full parameter reference for each API.

[Get my free API key](https://quanticdata.io/signup/) [Jump to endpoints](/docs/#endpoints)

$1 free every month · No card required · Pay per success

quickstart

```
$ export QD_API_KEY=qd_live_your_key_here
$ curl https://api.quanticdata.io/v1/scrape \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{ "url": "https://example.com" }'
{ "success": true,
  "data": { "markdown": "# Example Domain\n…" },
  "usage": { "cost_usd": 0.0002 } }
# one envelope, every endpoint: success · data · usage
```

## Authentication

Every request carries your key in the `Authorization` header: `Bearer $QD_API_KEY`. One key covers all Data APIs — scraping, SERP, map, crawl, batch and SEO audit share the same account, the same free allowance and the same rate limit budget.

Keys start on the pay-as-you-go tier: **$1 of free usage every month** with no card, 60 requests per minute, list unit prices. Subscription tiers raise limits and discount unit prices — see [pricing](https://quanticdata.io/#pricing).

One key, all APIs *Bearer auth* *$1 free / month* *60 req/min PAYG* *shared allowance*

## Endpoints

Base URL: `https://api.quanticdata.io/v1` — all endpoints accept JSON bodies via POST; job status endpoints are GET.

| Endpoint | What it does | Price · reference |
| --- | --- | --- |
| `POST /v1/scrape` | One page → Markdown, HTML or text; CSS or AI extraction | $0.0002 · Web Scraping API |
| `POST /v1/serp` | Search results as SerpApi-compatible JSON, 3 engines, 17 verticals | from $0.0005 · SERP API |
| `POST /v1/map` | Every URL of a site: sitemaps + homepage links, totals + sections | $0.0005 · Crawl & Map |
| `POST /v1/crawl` | Async BFS crawl to Markdown; poll `GET /v1/crawl/:jobId` | $0.0003/page · Crawl & Map |
| `POST /v1/batch` | Up to 1,000 known URLs; poll `GET /v1/batch/:jobId` | $0.0002/URL · Web Scraping API |
| `POST /v1/seo-audit` | No-JS + rendered views of a URL, diffed, with bot-facing meta | $0.0012 · SEO Audit API |

## The response envelope

Every endpoint answers with the same shape: `success`, `data` (the payload documented per product), and `usage` with the call's cost in USD. Failures return `success: false` with a machine-readable error code — and per the **pay-per-success** rule, a failed call costs nothing.

Calls that fight through blocks include a per-attempt retry log, so "why was this slow" has an answer in the response itself. Async jobs — crawl and batch — are charged up front on requested volume and **auto-refund the unfetched share** when the job settles.

envelope

```
{ "success": true,
  "data":    { … },
  "usage":   { "cost_usd": 0.0005 },
  "retries": [ { "attempt": 1, "outcome": "ok" } ] }
# success:false → error code, $0.00 charged
```

For AI agents

## MCP setup

The same platform as native agent tools — full guide on the [MCP server page](https://quanticdata.io/mcp-server/).

```
claude mcp add quantumproxies \
  -e QUANTUMPROXIES_API_KEY=qp_live_your_key_here \
  -- npx -y quantumproxies-mcp

# eight tools appear: search, scrape, map, crawl,
# crawl_status, batch, batch_status, seo_audit
```

```
// claude_desktop_config.json
{
  "mcpServers": {
    "quantumproxies": {
      "command": "npx",
      "args": ["-y", "quantumproxies-mcp"],
      "env": {
        "QUANTUMPROXIES_API_KEY": "qp_live_your_key_here"
      }
    }
  }
}
```

```
// .cursor/mcp.json
{
  "mcpServers": {
    "quantumproxies": {
      "command": "npx",
      "args": ["-y", "quantumproxies-mcp"],
      "env": {
        "QUANTUMPROXIES_API_KEY": "qp_live_your_key_here"
      }
    }
  }
}
```

## Full reference, per product

### [Web Scraping API](https://quanticdata.io/web-scraping-api/)

Formats, content modes, engines, CSS and AI extraction, batch options — with live request and response examples.

### [SERP API](https://quanticdata.io/serp-api/)

Engines, all 17 verticals, geo targeting with location and uule, pagination and the SerpApi-compatible response schema.

### [Crawl & Map](https://quanticdata.io/crawl-map/)

Job lifecycle, depth and limit controls, include/exclude filters, map's totals, sections and path tree.

### [SEO Audit](https://quanticdata.io/seo-audit/)

Both views, the diff fields, bot-facing meta and the cheaper no-render mode — plus site-wide audit recipes.

### [MCP Server](https://quanticdata.io/mcp-server/)

All eight tools with parameters, client-by-client install and how MCP billing maps to API billing.

### [Proxy networks](https://quanticdata.io/residential-proxies/)

Residential, mobile, datacenter, ISP and IPv6 endpoints, sticky vs rotating sessions and credential setup.

## First call in five minutes

$1 free every month, no card. One envelope, six endpoints, and an MCP server your agent already knows how to use.

[Get my free API key](https://quanticdata.io/signup/)

Also on the platform: [Web Scraping API](https://quanticdata.io/web-scraping-api/) [SERP API](https://quanticdata.io/serp-api/) [Crawl & Map API](https://quanticdata.io/crawl-map/) [SEO Audit API](https://quanticdata.io/seo-audit/) [Browser AI Agents](https://quanticdata.io/browser-ai/) [Web Data API for AI](https://quanticdata.io/web-data-api-for-ai/) [MCP Server](https://quanticdata.io/mcp-server/) [AI Web Scraping Service](https://quanticdata.io/ai-web-scraping-service/)

---

Source: https://quanticdata.io/docs/ · Site index for AI: https://quanticdata.io/llms.txt