Documentação da API

Esta página mostra endpoints reais do monitor com exemplo de chamada, retorno e status operacional em tempo real.

Base URL

Produção (Nginx): https://animeradar.shop/monitor-api

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

Endpoints com Status e Retorno

Online: 12Falha: 0
GET/operando

Inventário bruto atual em memória (debug rápido).

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/"

Exemplo de retorno

[
  {
    "id": "c83f3b6c88d89cdb284518c2c862a1bc05e1efc4",
    "timestamp": "2026-05-15T03:02:41.571Z",
    "refined": {
      "name": "Hirayasumi, Land, Tokyo Alien Bros., More Nominated for Eisner Awards",
      "url": "https://animenewsnetwork.com/news/2026-05-14/hirayasumi-land-tokyo-alien-bros-more-nominated-for-eisner-awards/.237369",
      "canonicalUrl": "https://animenewsnetwork.com/news/2026-05-14/hirayasumi-land-tokyo-alien-bros-more-nominated-for-eisner-awards/.237369",
      "domain": "animenewsnetwork.com",
      "pathname": "/news/2026-05-14/hirayasumi-land-tokyo-alien-bros-more-nominated-for-eisner-awards/.237369",
      "sourceId": "animenewsnetwork",
      "sourceName": "Anime News Network",
      "sourceType": "home",
      "bucket": "home",
      "categories": [
        "Manga"
      ],
      "categoriesNormalized": [
        "manga"
      ],
      "titleNormalized": "hirayasumi land tokyo alien bros more nominated for eisner awards",
      "contentType": "news",
      "publishedAt": "",
      "firstSeenAt": "2026-05-15T03:02:32.658Z",
      "lastSeenAt": "2026-05-15T03:17:52.237Z",
      "timesSeen": 2,
      "image": "https://www.animenewsnetwork.com/thumbnails/crop600x315gVN/cms/news.6/203404/hirayasumi.jpg",
      "summary": "As indicações para o **Will Eisner Comic Industry Awards 2026** foram oficialmente reveladas, destacando uma forte presença de mangás e produções ligadas à cultura japonesa. Na categoria de \"Melhor Edição Americana de Material Internacional – Ásia\", os destaques são *Hirayasumi* e *Tokyo Alien Bros.* (ambos de Keigo Shinzō...
GET/articlesoperando

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

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/articles?limit=5&offset=0"

Exemplo de retorno

{
  "total": 491,
  "limit": 5,
  "offset": 0,
  "hasMore": true,
  "filters": {
    "q": "",
    "sourceId": "",
    "bucket": "",
    "contentType": "",
    "lastSeenEvent": "",
    "from": ""
  },
  "items": [
    {
      "id": "c83f3b6c88d89cdb284518c2c862a1bc05e1efc4",
      "timestamp": "2026-05-15T03:02:41.571Z",
      "refined": {
        "url": "https://animenewsnetwork.com/news/2026-05-14/hirayasumi-land-tokyo-alien-bros-more-nominated-for-eisner-awards/.237369",
        "name": "Hirayasumi, Land, Tokyo Alien Bros., More Nominated for Eisner Awards",
        "image": "https://www.animenewsnetwork.com/thumbnails/crop600x315gVN/cms/news.6/203404/hirayasumi.jpg",
        "score": 42,
        "bucket": "home",
        "domain": "animenewsnetwork.com",
        "summary": "As indicações para o **Will Eisner Comic Industry Awards 2026** foram oficialmente reveladas, destacando uma forte presença de mangás e produções ligadas à cultura japonesa. Na categoria de \"Melhor Edição Americana de Material Internacional – Ásia\", os destaques são *Hirayasumi* e *Tokyo Alien Bros.* (ambos de Keigo Shinzō), além de *Land*, cuja autora, Kazumi Yamashita, também recebeu uma indicação individual como Melhor Escritora/Artista.\n\nA lista de indicados abrange diversos formatos, incluindo contos de Shintaro Kago e a biografia gráfica do renomado diretor de anime Rintarō, *My Life in 24 Frames per Second*. A edição de luxo em capa dura de *Akira*, da Kodansha USA, concorre como Melhor Projeto de Arquivamento, enquanto obras como *Fruits Basket* e o webcomic *DeadAss* aparecem em catego...
GET/articles/:idoperando

Retorna um artigo pelo ID interno.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/articles/:id"

Exemplo de retorno

{
  "item": {
    "id": "c83f3b6c88d89cdb284518c2c862a1bc05e1efc4",
    "timestamp": "2026-05-15T03:02:41.571Z",
    "refined": {
      "url": "https://animenewsnetwork.com/news/2026-05-14/hirayasumi-land-tokyo-alien-bros-more-nominated-for-eisner-awards/.237369",
      "name": "Hirayasumi, Land, Tokyo Alien Bros., More Nominated for Eisner Awards",
      "image": "https://www.animenewsnetwork.com/thumbnails/crop600x315gVN/cms/news.6/203404/hirayasumi.jpg",
      "score": 42,
      "bucket": "home",
      "domain": "animenewsnetwork.com",
      "summary": "As indicações para o **Will Eisner Comic Industry Awards 2026** foram oficialmente reveladas, destacando uma forte presença de mangás e produções ligadas à cultura japonesa. Na categoria de \"Melhor Edição Americana de Material Internacional – Ásia\", os destaques são *Hirayasumi* e *Tokyo Alien Bros.* (ambos de Keigo Shinzō), além de *Land*, cuja autora, Kazumi Yamashita, também recebeu uma indicação individual como Melhor Escritora/Artista.\n\nA lista de indicados abrange diversos formatos, incluindo contos de Shintaro Kago e a biografia gráfica do renomado diretor de anime Rintarō, *My Life in 24 Frames per Second*. A edição de luxo em capa dura de *Akira*, da Kodansha USA, concorre como Melhor Projeto de Arquivamento, enquanto obras como *Fruits Basket* e o webcomic *DeadAss* aparecem em categorias de design e quadrinhos digitais, respectivamente. 🏆\n\nO reconhecimento em massa no \"Oscar dos Quadrinhos\" reforça o prestígio global do mangá e a qualidade das adaptações para o mercado ocidental. Além das indicações...
GET/articles/slug/:slugoperando

Retorna um artigo pelo slug SEO.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/articles/slug/:slug"

Exemplo de retorno

{
  "item": {
    "id": "c83f3b6c88d89cdb284518c2c862a1bc05e1efc4",
    "timestamp": "2026-05-15T03:02:41.571Z",
    "refined": {
      "url": "https://animenewsnetwork.com/news/2026-05-14/hirayasumi-land-tokyo-alien-bros-more-nominated-for-eisner-awards/.237369",
      "name": "Hirayasumi, Land, Tokyo Alien Bros., More Nominated for Eisner Awards",
      "image": "https://www.animenewsnetwork.com/thumbnails/crop600x315gVN/cms/news.6/203404/hirayasumi.jpg",
      "score": 42,
      "bucket": "home",
      "domain": "animenewsnetwork.com",
      "summary": "As indicações para o **Will Eisner Comic Industry Awards 2026** foram oficialmente reveladas, destacando uma forte presença de mangás e produções ligadas à cultura japonesa. Na categoria de \"Melhor Edição Americana de Material Internacional – Ásia\", os destaques são *Hirayasumi* e *Tokyo Alien Bros.* (ambos de Keigo Shinzō), além de *Land*, cuja autora, Kazumi Yamashita, também recebeu uma indicação individual como Melhor Escritora/Artista.\n\nA lista de indicados abrange diversos formatos, incluindo contos de Shintaro Kago e a biografia gráfica do renomado diretor de anime Rintarō, *My Life in 24 Frames per Second*. A edição de luxo em capa dura de *Akira*, da Kodansha USA, concorre como Melhor Projeto de Arquivamento, enquanto obras como *Fruits Basket* e o webcomic *DeadAss* aparecem em categorias de design e quadrinhos digitais, respectivamente. 🏆\n\nO reconhecimento em massa no \"Oscar dos Quadrinhos\" reforça o prestígio global do mangá e a qualidade das adaptações para o mercado ocidental. Além das indicações...
GET/trendsoperando

Tendências por janela temporal (franquias, tópicos e fontes).

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/trends?windowHours=72&top=5"

Exemplo de retorno

{
  "generatedAt": "2026-05-15T03:19:14.441Z",
  "windowHours": 72,
  "totals": {
    "articles": 276,
    "sources": 10,
    "franchises": 264,
    "topics": 272
  },
  "topFranchises": [
    {
      "slug": "made-friends-with",
      "name": "Made Friends With",
      "mentions": 3,
      "sourceCount": 3,
      "avgScore": 114.67,
      "maxTrendScore": 13,
      "lastSeenAt": "2026-05-15T03:02:41.520000Z"
    },
    {
      "slug": "medaka-kuroiwa-impervious",
      "name": "Medaka Kuroiwa Impervious",
      "mentions": 3,
      "sourceCount": 3,
      "avgScore": 113.33,
      "maxTrendScore": 13,
      "lastSeenAt": "2026-05-15T03:02:41.520000Z"
    }
  ],
  "topTopics": [
    {
      "topicKey": "news|seven-seas-licenses|animenewsnetwork",
      "mentions": 2,
      "sourceCount": 1,
      "avgScore": 114.5,
      "lastSeenAt": "2026-05-15T03:02:41.520000Z"
    },
    {
      "topicKey": "news|hokuto-fist-north|animenewsnetwork",
      "mentions": 2,
      "sourceCount": 1,
      "avgScore": 99,
      "lastSeenAt": "2026-05-15T03:02:41.520000Z"
    }
  ],
  "topSources": [
    {
      "sourceId": "animenewsnetwork",
      "sourceName": "Anime News Network",
      "count": 149,
      "avgScore": 98.83,
      "newCount": 1,
      "revisitedCount": 148,
      "updatedCount": 0
    },
    {
      "sourceId": "otakunews",
      "sourceName": "Otaku News",
      "count": 32,
      "avgScore": 35.72,
      "newCount": 0,
      "revisitedCount": 32,
      "updatedCount": 0
    }
  ]
}
GET/sourcesoperando

Resumo agregado das fontes monitoradas.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/sources?top=10"

Exemplo de retorno

{
  "generatedAt": "2026-05-15T03:19:14.243Z",
  "total": 10,
  "top": 10,
  "windowHours": null,
  "items": [
    {
      "id": "animenewsnetwork",
      "name": "Anime News Network",
      "type": "Feed + Home",
      "description": "Coleta via Feed, Home em animenewsnetwork.com.",
      "monitorUrl": "https://www.animenewsnetwork.com/news",
      "feedUrl": "https://www.animenewsnetwork.com/news/rss.xml?ann-edition=w",
      "sitemapIndexUrl": "",
      "enabledSitemap": false,
      "collectionPriority": [
        "feed",
        "home"
      ],
      "stats": {
        "count": 281,
        "avgScore": 87.52,
        "newCount": 2,
        "revisitedCount": 279,
        "updatedCount": 0
      }
    },
    {
      "id": "animenew",
      "name": "AnimeNew",
      "type": "Feed + Home + Sitemap",
      "description": "Coleta via Feed, Home, Sitemap em animenew.com.br.",
      "monitorUrl": "https://animenew.com.br/",
      "feedUrl": "https://animenew.com.br/feed/",
      "sitemapIndexUrl": "https://animenew.com.br/sitemap_index.xml",
      "enabledSitemap": true,
      "collectionPriority": [
        "sitemap",
        "feed",
        "home"
      ],
      "stats": {
        "count": 82,
        "avgScore": 111.26,
        "newCount": 0,
        "revisitedCount": 80,
        "updatedCount": 2
      }
    }
  ]
}
GET/sources/:sourceIdoperando

Detalhe de uma fonte com paginação e distribuições.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/sources/:sourceId?limit=5&offset=0"

Exemplo de retorno

{
  "source": {
    "id": "animenewsnetwork",
    "name": "Anime News Network",
    "monitorUrl": "https://www.animenewsnetwork.com/news",
    "feedUrl": "https://www.animenewsnetwork.com/news/rss.xml?ann-edition=w",
    "enabledSitemap": false
  },
  "total": 281,
  "limit": 5,
  "offset": 0,
  "hasMore": true,
  "filters": {
    "sourceId": "animenewsnetwork",
    "bucket": "",
    "contentType": "",
    "lastSeenEvent": "",
    "from": "",
    "to": ""
  },
  "stats": {
    "lifecycle": {
      "new": 2,
      "revisited": 279,
      "updated": 0,
      "fetch_restricted": 0,
      "unknown": 0
    },
    "contentTypes": {
      "news": 274,
      "brief": 7
    }
  },
  "items": [
    {
      "id": "c83f3b6c88d89cdb284518c2c862a1bc05e1efc4",
      "timestamp": "2026-05-15T03:02:41.571Z",
      "refined": {
        "url": "https://animenewsnetwork.com/news/2026-05-14/hirayasumi-land-tokyo-alien-bros-more-nominated-for-eisner-awards/.237369",
        "name": "Hirayasumi, Land, Tokyo Alien Bros., More Nominated for Eisner Awards",
        "image": "https://www.animenewsnetwork.com/thumbnails/crop600x315gVN/cms/news.6/203404/hirayasumi.jpg",
        "score": 42,
        "bucket": "home",
        "domain": "animenewsnetwork.com",
        "summary": "As indicações para o **Will Eisner Comic Industry Awards 2026** foram oficialmente reveladas, destacando uma forte presença de mangás e produções ligadas à cultura japonesa. Na categoria de \"Melhor Edição Americana de Material Internacional – Ásia\", os destaques são *Hirayasumi* e *Tokyo Alien Bros.* (ambos de Keigo Shinzō),...
GET/franchisesoperando

Ranking de franquias detectadas no monitor.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/franchises?top=10"

Exemplo de retorno

{
  "generatedAt": "2026-05-15T03:19:14.854Z",
  "total": 454,
  "top": 10,
  "limit": 10,
  "offset": 0,
  "hasMore": true,
  "windowHours": null,
  "ranking": {
    "byMentions": [
      {
        "slug": "that-time-reincarnated",
        "name": "That Time Reincarnated",
        "mentions": 4,
        "sourceCount": 1,
        "avgScore": 68.25,
        "maxTrendScore": 13,
        "lastSeenAt": "2026-05-15T03:02:41.520000Z"
      },
      {
        "slug": "seven-seas-licenses",
        "name": "Seven Seas Licenses",
        "mentions": 3,
        "sourceCount": 1,
        "avgScore": 118.33,
        "maxTrendScore": 16,
        "lastSeenAt": "2026-05-15T03:02:41.520000Z"
      },
      {
        "slug": "hokuto-fist-north",
        "name": "Hokuto Fist North",
        "mentions": 3,
        "sourceCount": 1,
        "avgScore": 83.67,
        "maxTrendScore": 16,
        "lastSeenAt": "2026-05-15T03:02:41.520000Z"
      },
      {
        "slug": "made-friends-with",
        "name": "Made Friends With",
        "mentions": 3,
        "sourceCount": 3,
        "avgScore": 114.67,
        "maxTrendScore": 13,
        "lastSeenAt": "2026-05-15T03:02:41.520000Z"
      },
      {
        "slug": "medaka-kuroiwa-impervious",
        "name": "Medaka Kuroiwa Impervious",
        "mentions": 3,
        "sourceCount": 3,
        "avgScore": 113.33,
        "maxTrendScore": 13,
        "lastSeenAt": "2026-05-15T03:02:41.520000Z"
      }
    ],
    "byAvgScore": [
      {
        "slug": "agents-four-seasons",
        "name": "Agents Four Seasons",
        "mentions": 2,
      ...
GET/franchises/:slugoperando

Detalhe de franquia com artigos, distribuição por fonte e tipo.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/franchises/:slug?limit=5&offset=0"

Exemplo de retorno

{
  "slug": "that-time-reincarnated",
  "name": "That Time Reincarnated",
  "total": 4,
  "limit": 5,
  "offset": 0,
  "hasMore": false,
  "filters": {
    "sourceId": "",
    "bucket": "",
    "contentType": "",
    "lastSeenEvent": "",
    "from": "",
    "to": ""
  },
  "stats": {
    "sourceDistribution": [
      {
        "sourceId": "animenewsnetwork",
        "sourceName": "Anime News Network",
        "count": 4,
        "scoreTotal": 273,
        "newCount": 0,
        "revisitedCount": 4,
        "updatedCount": 0,
        "avgScore": 68.25
      }
    ],
    "contentTypeDistribution": {
      "news": 4
    }
  }
}
GET/seo/entitiesoperando

Agregações SEO por entidade (anime, personagem, estúdio, tag).

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/seo/entities?type=anime&top=10"

Exemplo de retorno

{
  "generatedAt": "2026-05-15T03:19:14.481Z",
  "type": "anime",
  "total": 10,
  "windowHours": null,
  "items": [
    {
      "type": "anime",
      "slug": "that-time-reincarnated",
      "name": "That Time Reincarnated",
      "count": 4,
      "sourceCount": 1,
      "avgScore": 68.25,
      "lastSeenAt": "2026-05-15T03:02:41.520Z"
    },
    {
      "type": "anime",
      "slug": "made-friends-with",
      "name": "Made Friends With",
      "count": 3,
      "sourceCount": 3,
      "avgScore": 114.67,
      "lastSeenAt": "2026-05-15T03:02:41.520Z"
    }
  ]
}
GET/seo/:type/:slugoperando

Detalhe de uma entidade SEO específica.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/seo/anime/:slug?limit=5&offset=0"

Exemplo de retorno

{
  "entity": {
    "type": "anime",
    "slug": "that-time-reincarnated",
    "name": "That Time Reincarnated",
    "count": 4,
    "sourceCount": 1,
    "avgScore": 68.25
  },
  "total": 4,
  "limit": 5,
  "offset": 0,
  "hasMore": false,
  "filters": {
    "sourceId": "",
    "bucket": "",
    "contentType": "",
    "lastSeenEvent": "",
    "from": "",
    "to": ""
  },
  "stats": {
    "sourceDistribution": [
      {
        "sourceId": "animenewsnetwork",
        "sourceName": "Anime News Network",
        "count": 4,
        "scoreTotal": 273,
        "newCount": 0,
        "revisitedCount": 4,
        "updatedCount": 0,
        "avgScore": 68.25
      }
    ],
    "contentTypeDistribution": {
      "news": 4
    }
  },
  "items": [
    {
      "id": "0f4a7e371c0c79cdac061fc98b39b1a4a58a4655",
      "timestamp": "2026-05-12T09:31:16.897Z",
      "refined": {
        "url": "https://animenewsnetwork.com/news/2026-05-12/2nd-that-time-i-got-reincarnated-as-a-slime-film-opens-in-the-philippines-on-may-23/.237284",
        "name": "2nd That Time I Got Reincarnated as a Slime Film Opens in the Philippines on May 23",
        "image": "https://www.animenewsnetwork.com/thumbnails/crop600x315gK2/encyc/A34556-2518405237.1763427815.jpg",
        "score": 50,
        "bucket": "home",
        "domain": "animenewsnetwork.com",
        "summary": "O segundo filme da franquia, intitulado *That Time I Got Reincarnated as a Slime the Movie: Tears of the Azure Sea*, estreará nas Filipinas em 23 de maio. Produzido pelo estúdio 8-Bit, o longa já passou pelos cinemas japoneses em fever...
GET/debug/sourcesoperando

Métricas técnicas do último ciclo por fonte e inventário.

Exemplo de chamada

curl -X GET "https://animeradar.shop/monitor-api/debug/sources"

Exemplo de retorno

{
  "isCheckingNews": true,
  "isShuttingDown": false,
  "sourcesActive": [
    "animenew",
    "animecorner"
  ],
  "inMemory": {
    "count": 491,
    "max": null
  },
  "inventory": {
    "totalArticles": 491,
    "restrictedFetchCount": 0,
    "byBucket": {
      "feed": 272,
      "home": 219,
      "sitemap": 0,
      "unknown": 0
    },
    "byContentType": {
      "news": 396,
      "unknown": 88,
      "brief": 7
    },
    "bySource": {
      "animenewsnetwork": {
        "total": 281,
        "byBucket": {
          "home": 180,
          "feed": 101
        },
        "byContentType": {
          "news": 274,
          "brief": 7
        },
        "lifecycle": {
          "new": 1,
          "revisited": 280,
          "updated": 0,
          "unknown": 0
        }
      },
      "animenew": {
        "total": 82,
        "byBucket": {
          "feed": 75,
          "home": 7
        },
        "byContentType": {
          "news": 82
        },
        "lifecycle": {
          "new": 0,
          "revisited": 80,
          "updated": 2,
          "unknown": 0
        }
      },
      "myanimelist": {
        "total": 10,
        "byBucket": {
          "feed": 10
        },
        "byContentType": {
          "unknown": 10
        },
        "lifecycle": {
          "new": 0,
          "revisited": 10,
          "updated": 0,
          "unknown": 0
        }
      },
      "otakuusa": {
        "total": 10,
        "byBucket": {
          "feed": 10
        },
        "byContentType": {
          "unknown": 10
        },
        "lifecycle": {
          "n...

Filtros e parâmetros

limit

Quantidade por página (padrão da API e máximo configurável).

offset

Deslocamento para paginação.

q

Busca textual (título, 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 conteúdo (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 tendências.