{"openapi":"3.1.0","info":{"title":"QuanticData Data API","version":"1.0.0","summary":"Web scraping, SERP, site map and SEO audit endpoints, pay-per-call.","description":"Pay-per-success Data API of QuanticData. Every successful call is billed at the listed price; failures and blocked pages are never charged. Full reference: https://quanticdata.io/docs/","termsOfService":"https://quanticdata.io/terms/","contact":{"name":"QuanticData support","email":"support@quanticdata.io","url":"https://quanticdata.io"}},"servers":[{"url":"https://api.quanticdata.io","description":"Production"}],"x-service-info":{"categories":["data","web-scraping","search","seo"],"docs":{"homepage":"https://quanticdata.io","apiReference":"https://quanticdata.io/docs/","llms":"https://quanticdata.io/llms.txt"}},"x-x402":{"status":"active","version":1,"scheme":"exact","network":"base","networkCaip2":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xeDcC778C241D32a17a473CcAffCba5620eFd86d7","catalog":"https://api.quanticdata.io/","note":"Call a payable operation without Authorization to get the 402 with payment requirements; settle happens only on a 2xx result."},"x-mpp":{"status":"active","spec":"https://paymentauth.org/ (draft-httpauth-payment-01, draft-stripe-charge-00)","method":"stripe","intent":"charge","model":"balance_topup","currency":"usd","vatRate":0.22,"defaultTopupUsd":0.5,"minTopupUsd":0.5,"maxTopupUsd":1000,"registration":"https://app.quanticdata.io/api/v1/agent/auth","note":"An MPP payment buys balance credit for the account of the API key that made the call (amounts exclude VAT; 22% VAT is added, as on every card top-up). It is offered on the 402 INSUFFICIENT_FUNDS of a call made with an API key; the call then runs and is billed from the balance at list price. No API key yet? Register at the registration URL first."},"tags":[{"name":"Data API","description":"Scraping, search and site intelligence."},{"name":"Meta","description":"Service information."}],"paths":{"/v1/scrape":{"post":{"operationId":"extract","summary":"Scrape one URL through residential proxies and get it back as Markdown, HTML or text","description":"Scrape one URL through residential proxies and get it back as Markdown, HTML or text (HTTP tier, no browser).\n\nAuthentication: `Authorization: Bearer <API key>` (free monthly allowance + prepaid balance), or pay per call with x402 (USDC on Base): call without a key to receive a 402 with the payment requirements.","tags":["Data API"],"security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"http/https URL to scrape"},"format":{"type":"string","description":"\"markdown\" (default) | \"html\" | \"text\""},"country":{"type":"string","description":"ISO country code for geo-targeting, e.g. \"us\""},"proxy_type":{"type":"string","description":"\"residential\" (default) | \"datacenter\" | \"mobile\": the exit network, priced per tier"},"max_cost":{"type":"number","description":"USD ceiling for this request: refused when the HTTP tier could exceed it, no browser escalation when only a render would"},"include_links":{"type":"boolean","description":"Return de-duplicated absolute links"}},"required":["url"],"additionalProperties":true}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}},"headers":{"Payment-Receipt":{"description":"Only on a request that paid an MPP balance top-up: base64url JSON receipt (status, method stripe, reference = Stripe PaymentIntent id, timestamp).","schema":{"type":"string"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"402":{"description":"Payment required (x402): the body lists the accepted payment requirements. For an API key whose balance and free tier cannot cover the call (payload.code INSUFFICIENT_FUNDS), the WWW-Authenticate: Payment header offers a balance top-up through the Machine Payments Protocol (method stripe, intent charge); retry the same request with Authorization: Payment <credential>. When the missing credit is more than one top-up may add, or the account's monthly spend cap is reached (payload.code BUDGET_REACHED), the envelope also carries `escalation` (type contact): ask the team for a higher limit at `contact_api` (POST /v1/agent/contact, same API key), or send the person to `contact_url`.","content":{"application/json":{"schema":{"type":"object","description":"x402 PaymentRequired (v1). Retry the same request with an X-PAYMENT header (base64 PaymentPayload).","properties":{"x402Version":{"type":"integer","const":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"maxAmountRequired":{"type":"string","description":"USDC atomic units (6 decimals)"},"resource":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"asset":{"type":"string"},"extra":{"type":"object","additionalProperties":true}}}}}}}},"headers":{"WWW-Authenticate":{"description":"MPP balance top-up challenge: Payment id=\"…\", realm=\"…\", method=\"stripe\", intent=\"charge\", request=\"<base64url JSON, amount in USD cents, VAT included>\", expires=\"…\", opaque=\"…\"","schema":{"type":"string"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}}},"x-price-usd":0.0015,"x-payment-info":{"intent":"charge","method":"evm","amount":"1500","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Scrape one URL through residential proxies and get it back as Markdown, HTML or text (HTTP tier, no browser). — 0.0015 USD per successful call, USDC on base"},"x-x402":{"scheme":"exact","network":"base","maxAmountRequired":"1500","resource":"https://api.quanticdata.io/v1/scrape","description":"Scrape one URL through residential proxies and get it back as Markdown, HTML or text (HTTP tier, no browser).","mimeType":"application/json","payTo":"0xeDcC778C241D32a17a473CcAffCba5620eFd86d7","maxTimeoutSeconds":60,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"}}}},"/v1/serp":{"post":{"operationId":"serp","summary":"Search engine results","description":"Search engine results (Google, Bing, DuckDuckGo) as structured JSON: organic results, ads, related searches.\n\nAuthentication: `Authorization: Bearer <API key>` (free monthly allowance + prepaid balance), or pay per call with x402 (USDC on Base): call without a key to receive a 402 with the payment requirements.","tags":["Data API"],"security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"engine":{"type":"string","description":"\"google\" (default) | \"bing\" | \"duckduckgo\""},"country":{"type":"string","description":"ISO country code (gl)"},"lang":{"type":"string","description":"Language code (hl)"},"num":{"type":"integer","description":"Results per page"},"page":{"type":"integer","description":"Page number"},"time_period":{"type":"string","description":"last_hour | last_day | last_week | last_month | last_year (Google); or start_date + end_date as YYYY-MM-DD"},"include_domains":{"type":"array","description":"Hostnames to search within (max 10), folded into the query as site: operators"},"exclude_domains":{"type":"array","description":"Hostnames to leave out (max 10)"},"fields":{"type":"array","description":"Dot paths that trim the answer, e.g. [\"organic.title\", \"organic.link\", \"ai_overview\"]"},"output":{"type":"string","description":"\"json\" (default) or \"markdown\": the parsed blocks as one Markdown document"},"ai_overview":{"type":"boolean","description":"Google web search: the AI Overview with its sources (ai_overview_references)"}},"required":["query"],"additionalProperties":true}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}},"headers":{"Payment-Receipt":{"description":"Only on a request that paid an MPP balance top-up: base64url JSON receipt (status, method stripe, reference = Stripe PaymentIntent id, timestamp).","schema":{"type":"string"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"402":{"description":"Payment required (x402): the body lists the accepted payment requirements. For an API key whose balance and free tier cannot cover the call (payload.code INSUFFICIENT_FUNDS), the WWW-Authenticate: Payment header offers a balance top-up through the Machine Payments Protocol (method stripe, intent charge); retry the same request with Authorization: Payment <credential>. When the missing credit is more than one top-up may add, or the account's monthly spend cap is reached (payload.code BUDGET_REACHED), the envelope also carries `escalation` (type contact): ask the team for a higher limit at `contact_api` (POST /v1/agent/contact, same API key), or send the person to `contact_url`.","content":{"application/json":{"schema":{"type":"object","description":"x402 PaymentRequired (v1). Retry the same request with an X-PAYMENT header (base64 PaymentPayload).","properties":{"x402Version":{"type":"integer","const":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"maxAmountRequired":{"type":"string","description":"USDC atomic units (6 decimals)"},"resource":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"asset":{"type":"string"},"extra":{"type":"object","additionalProperties":true}}}}}}}},"headers":{"WWW-Authenticate":{"description":"MPP balance top-up challenge: Payment id=\"…\", realm=\"…\", method=\"stripe\", intent=\"charge\", request=\"<base64url JSON, amount in USD cents, VAT included>\", expires=\"…\", opaque=\"…\"","schema":{"type":"string"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}}},"x-price-usd":0.002,"x-payment-info":{"intent":"charge","method":"evm","amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Search engine results (Google, Bing, DuckDuckGo) as structured JSON: organic results, ads, related searches. — 0.002 USD per successful call, USDC on base"},"x-x402":{"scheme":"exact","network":"base","maxAmountRequired":"2000","resource":"https://api.quanticdata.io/v1/serp","description":"Search engine results (Google, Bing, DuckDuckGo) as structured JSON: organic results, ads, related searches.","mimeType":"application/json","payTo":"0xeDcC778C241D32a17a473CcAffCba5620eFd86d7","maxTimeoutSeconds":60,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"}}}},"/v1/map":{"post":{"operationId":"map","summary":"Discover the URLs of a website","description":"Discover the URLs of a website (sitemaps + crawl of the home page) with an optional keyword filter.\n\nAuthentication: `Authorization: Bearer <API key>` (free monthly allowance + prepaid balance), or pay per call with x402 (USDC on Base): call without a key to receive a 402 with the payment requirements.","tags":["Data API"],"security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Site URL"},"limit":{"type":"integer","description":"Max URLs to return"},"search":{"type":"string","description":"Keep only URLs matching this text"},"includeSubdomains":{"type":"boolean","description":"Include subdomains"}},"required":["url"],"additionalProperties":true}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}},"headers":{"Payment-Receipt":{"description":"Only on a request that paid an MPP balance top-up: base64url JSON receipt (status, method stripe, reference = Stripe PaymentIntent id, timestamp).","schema":{"type":"string"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"402":{"description":"Payment required (x402): the body lists the accepted payment requirements. For an API key whose balance and free tier cannot cover the call (payload.code INSUFFICIENT_FUNDS), the WWW-Authenticate: Payment header offers a balance top-up through the Machine Payments Protocol (method stripe, intent charge); retry the same request with Authorization: Payment <credential>. When the missing credit is more than one top-up may add, or the account's monthly spend cap is reached (payload.code BUDGET_REACHED), the envelope also carries `escalation` (type contact): ask the team for a higher limit at `contact_api` (POST /v1/agent/contact, same API key), or send the person to `contact_url`.","content":{"application/json":{"schema":{"type":"object","description":"x402 PaymentRequired (v1). Retry the same request with an X-PAYMENT header (base64 PaymentPayload).","properties":{"x402Version":{"type":"integer","const":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"maxAmountRequired":{"type":"string","description":"USDC atomic units (6 decimals)"},"resource":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"asset":{"type":"string"},"extra":{"type":"object","additionalProperties":true}}}}}}}},"headers":{"WWW-Authenticate":{"description":"MPP balance top-up challenge: Payment id=\"…\", realm=\"…\", method=\"stripe\", intent=\"charge\", request=\"<base64url JSON, amount in USD cents, VAT included>\", expires=\"…\", opaque=\"…\"","schema":{"type":"string"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}}},"x-price-usd":0.003,"x-payment-info":{"intent":"charge","method":"evm","amount":"3000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Discover the URLs of a website (sitemaps + crawl of the home page) with an optional keyword filter. — 0.003 USD per successful call, USDC on base"},"x-x402":{"scheme":"exact","network":"base","maxAmountRequired":"3000","resource":"https://api.quanticdata.io/v1/map","description":"Discover the URLs of a website (sitemaps + crawl of the home page) with an optional keyword filter.","mimeType":"application/json","payTo":"0xeDcC778C241D32a17a473CcAffCba5620eFd86d7","maxTimeoutSeconds":60,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"}}}},"/v1/seo-audit":{"post":{"operationId":"seo_audit","summary":"Technical SEO audit of one page","description":"Technical SEO audit of one page: meta tags, headings, links, structured data, Core Web Vitals hints.\n\nAuthentication: `Authorization: Bearer <API key>` (free monthly allowance + prepaid balance), or pay per call with x402 (USDC on Base): call without a key to receive a 402 with the payment requirements.","tags":["Data API"],"security":[{"ApiKeyAuth":[]},{}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Page URL"},"country":{"type":"string","description":"ISO country code"},"no_render":{"type":"boolean","description":"Skip the browser pass (cheaper, fewer checks)"}},"required":["url"],"additionalProperties":true}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}},"headers":{"Payment-Receipt":{"description":"Only on a request that paid an MPP balance top-up: base64url JSON receipt (status, method stripe, reference = Stripe PaymentIntent id, timestamp).","schema":{"type":"string"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}},"402":{"description":"Payment required (x402): the body lists the accepted payment requirements. For an API key whose balance and free tier cannot cover the call (payload.code INSUFFICIENT_FUNDS), the WWW-Authenticate: Payment header offers a balance top-up through the Machine Payments Protocol (method stripe, intent charge); retry the same request with Authorization: Payment <credential>. When the missing credit is more than one top-up may add, or the account's monthly spend cap is reached (payload.code BUDGET_REACHED), the envelope also carries `escalation` (type contact): ask the team for a higher limit at `contact_api` (POST /v1/agent/contact, same API key), or send the person to `contact_url`.","content":{"application/json":{"schema":{"type":"object","description":"x402 PaymentRequired (v1). Retry the same request with an X-PAYMENT header (base64 PaymentPayload).","properties":{"x402Version":{"type":"integer","const":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"maxAmountRequired":{"type":"string","description":"USDC atomic units (6 decimals)"},"resource":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"asset":{"type":"string"},"extra":{"type":"object","additionalProperties":true}}}}}}}},"headers":{"WWW-Authenticate":{"description":"MPP balance top-up challenge: Payment id=\"…\", realm=\"…\", method=\"stripe\", intent=\"charge\", request=\"<base64url JSON, amount in USD cents, VAT included>\", expires=\"…\", opaque=\"…\"","schema":{"type":"string"}}}},"429":{"description":"Rate limit reached","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}}},"x-price-usd":0.003,"x-payment-info":{"intent":"charge","method":"evm","amount":"3000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Technical SEO audit of one page: meta tags, headings, links, structured data, Core Web Vitals hints. — 0.003 USD per successful call, USDC on base"},"x-x402":{"scheme":"exact","network":"base","maxAmountRequired":"3000","resource":"https://api.quanticdata.io/v1/seo-audit","description":"Technical SEO audit of one page: meta tags, headings, links, structured data, Core Web Vitals hints.","mimeType":"application/json","payTo":"0xeDcC778C241D32a17a473CcAffCba5620eFd86d7","maxTimeoutSeconds":60,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"}}}},"/v1/health":{"get":{"operationId":"health","summary":"Service health","tags":["Meta"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["response","error"]},"message":{"type":"string"},"payload":{"type":"object","additionalProperties":true}},"required":["type","message"]}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"API key from https://app.quanticdata.io/api-keys (free account, no card)."}}}}