API Docs · v1

Documentação da API

Base URL: https://radartrend.com.br/api/v1/public

Autenticação & limites

• Autenticação: não necessária pra endpoints públicos
• Rate limit: 60 requests/minuto por IP
• Cache: respostas têm Cache-Control (5-60min) — respeite pra não bater no limite
• Formato: JSON
• CORS: habilitado pra domínios não-autenticados

GET /trends

Lista tendências públicas com score >= 60, ordenadas por score desc.

Query params

Resposta (200)

{
  "meta": {
    "count": 20,
    "generated_at": "2026-04-21T20:00:00+00:00",
    "docs": "https://radartrend.com.br/api-docs"
  },
  "data": [
    {
      "id": 14335,
      "title": "OpenAI lança GPT-5 com raciocínio multimodal",
      "category": "tech",
      "score": 92,
      "source": "hackernews",
      "url": "https://news.ycombinator.com/item?id=123",
      "created_at": "2026-04-21T18:15:00+00:00",
      "public_url": "https://radartrend.com.br/topico/14335/openai-gpt5"
    }
  ]
}

Exemplos

# Top 10 trends de tecnologia
curl "https://radartrend.com.br/api/v1/public/trends?category=tech&limit=10"

# Trends alpha (score >= 85) das últimas 48h
curl "https://radartrend.com.br/api/v1/public/trends?min_score=85&since=48"

GET /trends/{id}

Detalhes de 1 tendência, incluindo análise IA.

Resposta (200)

{
  "data": {
    "id": 14335,
    "title": "OpenAI lança GPT-5 com raciocínio multimodal",
    "category": "tech",
    "score": 92,
    "source": "hackernews",
    "url": "...",
    "created_at": "2026-04-21T18:15:00+00:00",
    "public_url": "...",
    "summary": "GPT-5 introduz raciocínio multimodal...",
    "recommendation": "Alta — impacto em produtos de IA nos próximos 30 dias",
    "keywords": ["IA", "OpenAI", "GPT", "multimodal"]
  }
}

Erro 404: trend inexistente ou com score < 60.

GET /sources

Lista das 13 fontes monitoradas (cache 24h).

{
  "meta": { "count": 13, "generated_at": "..." },
  "data": [
    { "id": "hackernews", "name": "Hacker News", "category": "tech", "region": "global", "url": "..." },
    { "id": "arxiv", "name": "Arxiv", "category": "science", "region": "global", "url": "..." }
  ]
}

Códigos de erro