---
title: "run_domain_analysis"
method: POST
path: "/api/v1/run_domain_analysis"
---

# run_domain_analysis

`POST /api/v1/run_domain_analysis`

## Request

- Base URL: `https://app.miraqo.io`
- URL: `https://app.miraqo.io/api/v1/run_domain_analysis`
- Auth: HTTP bearer

Analisi della concorrenza di un dominio: keyword organiche, traffico stimato, top keyword/pagine. I dati sono PER MERCATO (default: Italia/it) — lo stesso dominio su google.ch e su google.it dà numeri diversi. Se esiste uno snapshot più recente di 7 giorni per quel mercato lo riusa GRATIS (cached=true); altrimenti refresh (~30-60s). AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui.

## Request body

- object
  - `domain` string, required: dominio nudo, es. "esempio.it"
  - `organization_id` integer
  - `location_code` integer: codice paese (es. 2756 = Svizzera); default 2380 (Italia)
  - `language_code` string: lingua SERP del paese (es. "de"); default: la principale del paese

## Response `200`

ok=true, risultato in data

## Other responses

- `400`: ok=false, messaggio in error

---

[API](https://skmtc.dev/miraqo/apis/miraqo-api.md) · [All operations](https://skmtc.dev/miraqo/apis/miraqo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/miraqo/apis/miraqo-api/revisions/6c922bc12f0e?raw)