Documentacao da API

Esta pagina reflete os endpoints reais do monitor. O frontend usa os mesmos contratos para listar noticias, tendencias, franquias e fontes.

Base URL

Producao (Nginx): https://omnizap.xyz/monitor-api

Local (API direta): http://127.0.0.1:3000

Endpoints disponiveis

GET/

Inventario bruto atual em memoria (debug rapido).

GET/articles

Lista paginada de artigos com filtros por texto, fonte, bucket, tipo e datas.

GET/articles/:id

Retorna um artigo pelo ID interno.

GET/articles/slug/:slug

Retorna um artigo pelo slug SEO.

GET/trends

Tendencias por janela temporal (franquias, topicos e fontes).

GET/sources

Resumo agregado das fontes monitoradas.

GET/sources/:sourceId

Detalhe de uma fonte com paginação e distribuicoes.

GET/franchises

Ranking de franquias detectadas no monitor.

GET/franchises/:slug

Detalhe de franquia com artigos, distribuicao por fonte e tipo.

GET/seo/entities

Agregacoes SEO por entidade (anime, personagem, estudio, tag).

GET/seo/:type/:slug

Detalhe de uma entidade SEO especifica.

GET/debug/sources

Metricas tecnicas do ultimo ciclo por fonte e inventario.

Filtros e parametros

limit

Quantidade por pagina (padrao da API e maximo configuravel).

offset

Deslocamento para paginação.

q

Busca textual (titulo, resumo, entidades e campos relacionados).

source | sourceId

Filtra por ID da fonte (ex.: animenewsnetwork).

bucket

Filtra por bucket: feed, home ou sitemap.

contentType

Filtra por tipo de conteudo (news, brief, unknown).

lastSeenEvent

Filtra por evento de ciclo: new, revisited, updated, fetch_restricted.

from / to

Faixa temporal em formato de data ISO.

windowHours

Janela em horas para /trends, /sources e /franchises.

top

Top N de agregados para rankings e tendencias.

Exemplos reais (cURL)

# 1) Noticias mais recentes
curl -X GET "https://omnizap.xyz/monitor-api/articles?limit=12&offset=0"

# 2) Busca por termo + filtro de fonte
curl -X GET "https://omnizap.xyz/monitor-api/articles?q=one%20piece&source=animenewsnetwork&limit=20"

# 3) Tendencias das ultimas 72 horas
curl -X GET "https://omnizap.xyz/monitor-api/trends?windowHours=72&top=10"

# 4) Detalhe por slug SEO
curl -X GET "https://omnizap.xyz/monitor-api/articles/slug/japanese-animation-tv-ranking-march-2-8-2026-03-15"