> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.vturb.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# API do Analytics

Se você quer integrar as métricas do Analytics do VTurb com outras ferramentas ou relatórios personalizados, pode usar nossa **API pública do Analytics**.

### 📚 Documentação oficial

A documentação está disponível neste link: [https://vturb.gitbook.io/analytics-api/pt](https://vturb.gitbook.io/analytics-api/pt)

Nela, você encontra:
* Como gerar e usar sua chave de API (autenticação)
* Endpoints disponíveis (plays, visualizações, retenção, etc...)
* Parâmetros para filtrar dados (por vídeo, data, origem de tráfego)
* Exemplos de uso com `curl` e `JavaScript`
* Estrutura das respostas da API

### 🔑 Como gerar sua chave de API
1. Acesse seu painel na VTurb
![](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_17w9m6z.png)

2. Vá em **Configurações > API do Analytics** e clique em "Gerar Nova Chave de API"
![](https://storage.crisp.chat/users/helpdesk/website/-/3/9/0/a/390a843820d6ba00/image_vw1tbq.png =1000x800)

⚠️ **Importante:** nunca exponha sua chave em código público (como scripts no navegador)

### 👨‍💻 Para que serve?
A API é ideal para quem precisa:
* Integrar dados do VTurb com ferramentas de BI (como Power BI, Google Data Studio, etc...)
* Automatizar relatórios
* Criar dashboards personalizados
* Consolidar dados de várias contas


### ➡️ Exemplos de Automações com N8N
Separamos alguns exemplos de automações pra você conectar nossa API utilizando a ferramenta N8N.
[Clique aqui para acessar o drive com os templates!](https://drive.google.com/drive/folders/10Y8E2X93r9dB70Xs-EmtWYCLB2hknnyU)


### ⚙️ Dicas de uso
* Sempre utilize **filtros e paginação** nas requisições para evitar sobrecarga
* Use tokens com cuidado e armazene com segurança.

Se tiver dúvidas ou sugestões sobre a API, fale com nosso time de Suporte no [Chat](https://go.crisp.chat/chat/embed/?website_id=064e812f-2997-4b04-978b-b2516f33e989) ou no [WhatsApp](https://api.whatsapp.com/send/?phone=5548991786092)!