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

# get_keyword_gap

`POST /api/v1/get_keyword_gap`

## Request

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

Keyword gap dai competitor: keyword per cui un competitor si posiziona, con volume, posizione, difficulty, cpc e URL. only_uncovered=true (default) mostra solo quelle che il progetto NON copre. Paginato (max 100).

## Request body

- object
  - `project_id` integer, required: ID progetto (da list_projects)
  - `competitor_id` integer: ID da get_competitors; omesso = tutti
  - `only_uncovered` boolean
  - `limit` integer
  - `offset` integer
  - `location_code` integer: mercato dello snapshot gap; omesso = mercato del progetto. Altri mercati esistono solo se già analizzati dalla pagina Competitor.

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