Documentation - Memerator API

Navigation

Introduction
End-Points

Welcome to Memerator API Documentation!

If you haven't already, you need to make an API key, so you can talk to us!

Introduction

Welcome to the Memerator API Documentation. Don't you just love developing?

All end-points are rooted at https://memerator.me/api/v1

Authorization

To talk to us, you need some Authorization. Simply head to API key to get you set up! It's crucial to not tell anyone this! It's secure, for you, and with it, anyone can use your account. All requests require authorization.

End-Points

GET /meme/:id

Gets data from a meme based off of ID.

Sample Request: https://memerator.me/api/v1/meme/AAAAAA

Sample Response:

{
    memeid: "AAAAAA",
    caption: "AAAAAAAA",
    author: "Billy Sprinklecake#0000",
    rating: 1,
    url: "https://meme-o-rama.example.com/epic.png",
    permalink: "https://memerator.me/meme/AAAAAA",
    timestamp: "2018-12-12T16:16:03.000-06:00",
    "time_ago": "about 1 month"
}

GET /mymemes

Returns an array list of your memes. This may take a few seconds to process depending on all the memes.

Sample Request: https://memerator.me/api/v1/mymemes

Sample Response:

[
  {
    memeid: "AAAAAA",
    caption: "AAAAAAAA",
    author: "Billy Sprinklecake#0000",
    rating: 1,
    url: "https://meme-o-rama.example.com/epic.png",
    permalink: "https://memerator.me/meme/AAAAAA",
    timestamp: "2018-12-12T16:16:03.000-06:00",
    "time_ago": "about 1 month"
  },
  {
    memeid: "BBBBBB",
    caption: "BBBBBB",
    author: "Billy Sprinklecake#0000",
    rating: 5,
    url: "https://meme-o-rama.example.com/dank.png",
    permalink: "https://memerator.me/meme/BBBBBB",
    timestamp: "2018-10-12T16:16:03.000-06:00",
    "time_ago": "about 3 months"
  }
]

GET /stats

Gets the site's stats.

Sample Request: https://memerator.me/api/v1/stats

Sample Response:

{
    "memes": 49,
    "ratings": 36,
    "website_users": 5,
    "unique_memers": 4
}