Referência

Endpoints

Todos são GET e começam por http://localhost:4000/api/v1. Para experimentar cada um no navegador, abre a documentação interativa.

Rotas

Rota	O que faz	Parâmetros
/memes	Pesquisar e listar memes.	type, q, tag, sort (recent \| popular \| random), seed, page, limit (máx. 50)
/memes/random	Um meme ao acaso. Ótimo para bots.	type, tag
/memes/{idOrSlug}	Detalhe de um meme, pelo id ou pelo slug.	—
/tags	Tags com pelo menos 1 meme, as mais usadas primeiro.	—

Exemplo de resposta

GET /memes/ya-mano

{
  "meme": {
    "id": "3e5d2560-685c-479d-a237-d7043ab0fad9",
    "slug": "ya-mano",
    "type": "video",
    "title": "Ya mano",
    "tags": [{ "slug": "kuduro", "name": "Kuduro" }],
    "fileUrl": "https://res.cloudinary.com/…/ya-mano.mp4",
    "thumbUrl": "https://res.cloudinary.com/…/ya-mano.jpg",
    "previewUrl": "https://res.cloudinary.com/…/ya-mano.mp4",
    "downloadUrl": "https://res.cloudinary.com/…/fl_attachment:ya-mano/…",
    "durationMs": 5573,
    "width": 640,
    "height": 360,
    "downloadsCount": 12,
    "pageUrl": "https://angomemes.ao/memes/ya-mano",
    "publishedAt": "2026-10-06T09:58:12.984Z"
  }
}