Meme Server API

Use this API to vote on memes, fetch leaderboard data, and inspect vote totals for a specific meme hash.

Endpoints

• GET /api/meme/top - Get the current top memes by vote count.
• POST /api/meme/vote - Cast an upvote or downvote for a meme.
• GET /api/meme/votes/:hash - Get vote totals for a specific meme hash. Example: /api/meme/votes/demo-hash
• POST /api/meme/admin/clear - Clear all stored votes with a valid admin key.
• GET /top - Alternate top memes endpoint.
• random GET /api/meme/random - Get a random selection of memes.

How to use

Submit JSON requests with Content-Type: application/json.

Vote for a meme

POST /api/meme/vote
{
  "hash": "demo-hash",
  "value": 1
}

Clear votes as admin

POST /api/meme/admin/clear
{
  "adminKey": "your-admin-key"
}