api v1 · Escuta Viva
Integre a operação ao seu site, CRM ou painel
Endpoints REST em JSON, CORS liberado e autenticação por chave de API criada no painel. Cada chave tem escopo de leitura ou de leitura e escrita e registra o último uso.
Gerar minha chaveAutenticação
Envie a chave em um dos dois cabeçalhos. Requisições sem chave válida retornam 401; chaves sem o escopo necessário retornam 403.
Authorization: Bearer SUA_CHAVE
x-api-key: SUA_CHAVEEndpoints
| método | endpoint | escopo | descrição |
|---|---|---|---|
| GET | /api/public/v1/health | leitura | Valida a chave e retorna as permissões. |
| GET | /api/public/v1/posts | leitura | Conteúdos captados. Filtros: limit, offset, since, author, hashtag. |
| POST | /api/public/v1/posts | escrita | Envia conteúdos captados (um objeto ou {posts:[…]}, até 100, sem duplicar por URL). |
| GET | /api/public/v1/comments | leitura | Interações geradas e publicadas. Filtros: status, since, limit, offset. |
| GET | /api/public/v1/stats | leitura | Totais, série por dia, tipos de conteúdo, top perfis e hashtags (days=1..90). |
| GET | /api/public/v1/config | leitura | Lê toda a configuração da operação (modo, limites, janela, temas, tom, nome). |
| PATCH | /api/public/v1/config | escrita | Edita qualquer campo configurável: mode, is_active, daily_limit, min_interval_minutes, start_hour, end_hour, topics, auto_topics, tone_notes, candidate_name. |
Campos editáveis da operação
| campo | valores | descrição |
|---|---|---|
| mode | "manual" | "semi" | "autonomous" | Modo de operação |
| is_active | boolean | Liga ou desliga a operação |
| daily_limit | 1–60 | Limite de interações por dia |
| min_interval_minutes | 3–240 | Intervalo mínimo entre interações |
| start_hour | 0–23 | Início da janela de operação |
| end_hour | 1–24 | Fim da janela de operação |
| topics | string[] | Temas prioritários |
| auto_topics | string[] | Temas liberados para o modo autônomo |
| tone_notes | string | Diretriz de tom de voz |
| candidate_name | string | Nome da liderança / chapa |
Exemplos
Ler conteúdos captados
curl "https://SEU-DOMINIO/api/public/v1/posts?limit=50&since=2026-01-01" \
-H "Authorization: Bearer SUA_CHAVE"Enviar conteúdos captados
curl -X POST "https://SEU-DOMINIO/api/public/v1/posts" \
-H "Authorization: Bearer SUA_CHAVE" \
-H "content-type: application/json" \
-d '{"posts":[{"post_url":"https://www.instagram.com/p/ABC/","author_username":"perfil","caption":"texto","hashtags":["#pauta"],"content_type":"foto","likes":120,"comments":8}]}'Ler a configuração da operação
curl "https://SEU-DOMINIO/api/public/v1/config" \
-H "x-api-key: SUA_CHAVE"Editar a configuração
curl -X PATCH "https://SEU-DOMINIO/api/public/v1/config" \
-H "x-api-key: SUA_CHAVE_COM_ESCRITA" \
-H "content-type: application/json" \
-d '{"mode":"semi","daily_limit":20,"start_hour":8,"end_hour":22,"topics":["saude","educacao"]}'contato
Pronto para consolidar seu projeto com uma equipe de excelência?
Conte o cargo, a praça e o prazo. Devolvemos um diagnóstico inicial e o escopo possível — sem discurso pronto.
- Belo Horizonte — MG
Rua Professor Eugênio Murilo Rubião, 222 — Anchieta - Brasília — DF
Ed. Lê Quartier, SHCN, sala 420 - Florianópolis — SC
Av. Prof. Othon Gama D'Eça, 677 — Sala 603 — Centro