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

# get_keywords

`POST /api/v1/get_keywords`

## Request

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

Keyword tracciate di un progetto con ultima posizione, posizione del check precedente e variazione (`change`: positivo = salita, negativo = scesa; fuori Top 100 conta 100), URL e SERP AI Overview, più summary (media posizioni, top 3/10). order_by=change mette per prime le più scese. Paginato (max 100).

## Request body

- object
  - `project_id` integer, required: ID progetto (da list_projects)
  - `query` string: filtro sottostringa sulla keyword
  - `device` 'desktop' | 'mobile'
  - `order_by` 'change' | 'difficulty' | 'keyword' | 'position' | 'volume'
  - `limit` integer
  - `offset` integer

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