Pro Divulgas | Divulga Grupos e Links com IA

Visão Geral

A API pública do Pro Divulgas permite integrar grupos de WhatsApp, Telegram, Discord e outras plataformas diretamente no seu app, bot ou site.

Atualmente em versão beta aberto. Endpoints autenticados com chave de API, envio de grupos e webhooks estão em desenvolvimento ativo.

Todos os endpoints retornam JSON e suportam CORS. Endpoints marcados como público não requerem autenticação.

Versionamento

A API atual não usa prefixo de versão explícito. Quando o versionamento formal for introduzido, os endpoints migrarão para /api/v1/ com compatibilidade retroativa por 6 meses.

v0

Beta atual

ativo

v1

Com auth + envio

em breve

v2

Webhooks + Stream

planejado

Códigos de Erro

Código	Significado	Causa comum
200	OK	Requisição bem-sucedida
400	Bad Request	Parâmetro inválido ou ausente
404	Not Found	Recurso não encontrado
429	Too Many Requests	Rate limit excedido (60 req/min)
500	Server Error	Erro interno — tente novamente

Grupos Promovidos

Disponível

GET /api/groups/promoted Público · Sem auth

Retorna todos os grupos aprovados com promoção ativa: VIP Plus, Premium ou Impulso. Ordenados por prioridade (Plus > Premium > Impulso) e dentro do mesmo plano, do mais recente para o mais antigo.

URL completa

GET https://prodivulgas.com/api/groups/promoted

Headers

Header	Valor	Obrigatório
Accept	application/json	não
Authorization	—	não necessário

Query parameters

Este endpoint não aceita parâmetros de query nesta versão.

cURL

curl -X GET \
  https://prodivulgas.com/api/groups/promoted \
  -H "Accept: application/json"

200 OK Array JSON ordenado por promoção

[
  {
    "_id": "64f3a2b1c8e4d00012345678",
    "name": "Grupos Premium BR",
    "description": "Comunidade premium de divulgação...",
    "category": "Tecnologia",
    "platform": "telegram",
    "link": "https://t.me/exemplo",
    "foto": "https://cdn.example.com/foto.jpg",
    "slug": "grupos-premium-br",
    "tags": ["tecnologia", "premium", "grupos"],
    "verified": false,
    "plus": true,
    "premium": false,
    "impulso": false,
    "plusExpiresAt": "2026-06-01T00:00:00.000Z",
    "premiumExpiresAt": null,
    "views": 1240,
    "status": "approved",
    "createdAt": "2025-11-10T14:32:00.000Z",
    "owner": { "username": "usuario_exemplo" }
  }
]

Campo	Tipo	Descrição
_id	string	ID único
name	string	Nome do grupo
description	string\|null	Descrição do grupo
category	string	Categoria (ex: Tecnologia)
platform	string	`telegram` `whatsapp` `discord` …
link	string	Link de convite
foto	string\|null	URL da imagem
slug	string	Slug amigável de URL
tags	string[]	Tags geradas por IA
verified	boolean	Possui Selo Verificado
plus	boolean	VIP Plus ativo
premium	boolean	Premium ativo
impulso	boolean	Impulso grátis ativo
plusExpiresAt	string\|null	ISO 8601 — expiração VIP Plus
premiumExpiresAt	string\|null	ISO 8601 — expiração Premium
views	number	Total de visualizações
createdAt	string	ISO 8601 — data de criação
owner.username	string	Nome do dono do grupo

JavaScript (fetch)

const res = await fetch('https://prodivulgas.com/api/groups/promoted');
const groups = await res.json();

groups.forEach(group => {
  console.log(group.name, group.platform, group.link);
});

Python (requests)

import requests

r = requests.get('https://prodivulgas.com/api/groups/promoted')
groups = r.json()

for g in groups:
    print(g['name'], g['platform'], g['link'])

Node.js (axios)

const axios = require('axios');

const { data: groups } = await axios.get(
  'https://prodivulgas.com/api/groups/promoted'
);

const plusOnly = groups.filter(g => g.plus);

Dados de um Grupo

Em Breve

GET /api/groups/:slug

Retorna os dados completos de um grupo específico a partir do seu slug ou _id. Inclui descrição, tags, promoção ativa, avaliações e dados do dono.

Grupos por Categoria

Em Breve

GET /api/groups/category/:category ?page=1&limit=20

Listagem paginada de grupos aprovados de uma categoria, ordenados por plano de promoção. Suporta filtros por plataforma e status de verificação.

Enviar Novo Grupo

Em Breve

POST /api/groups Requer API Key

Cria e envia um novo grupo para aprovação diretamente via API. Requer autenticação com API Key. A IA Guard analisa o conteúdo automaticamente.

Meus Grupos

Em Breve

GET /api/me/groups Requer API Key

Lista todos os grupos do usuário autenticado, incluindo grupos pendentes, aprovados, status de promoção e validade dos planos contratados.

Autenticação via API Key

Em Breve

Endpoints privados exigirão Bearer token gerado no painel do usuário.

Authorization: Bearer pdv_live_xxxxxxxxxxxxxxxxxxxxx

Webhooks

Em Breve

Receba eventos em tempo real quando grupos forem aprovados, promovidos ou atualizados na plataforma.

group.approved

group.promoted

group.updated

group.removed

API Pública

Visão Geral

Versionamento

Códigos de Erro

Grupos Promovidos

Dados de um Grupo

Grupos por Categoria

Enviar Novo Grupo

Meus Grupos

Autenticação via API Key

Webhooks

Tem sugestões para a API?