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

# get_youtube_rankings

`POST /api/v1/get_youtube_rankings`

## Request

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

Posizioni del canale YouTube del progetto nella ricerca di YouTube per le keyword monitorate «anche su YouTube» (primi 20 video). Senza keyword: ultimo check di ogni keyword con la top 20 (canale, views, titolo). Con keyword: storico fino a 365 giorni. position null = nessun video del canale fra i primi 20.

## Request body

- object
  - `project_id` integer, required: ID progetto (da list_projects)
  - `keyword` string: testo esatto della keyword (opzionale: storico)
  - `days` 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)