Meme

Information about the meme object

The Meme object is returned when requesting 1 or multiple memes. An example object is as follows.

Field

Type

Description

disabled

boolean

is the meme disabled?

memeid

string

the meme's id

caption

string

the meme's caption

author

User

a user object of the author

rating

hash

hash of the rating, with the average and total ratings

url

string

the url of the image of the meme

permalink

string

the url of the meme on memerator.me

timestamp

timestamp

when the meme was submitted

time_ago

string

what appears on the website how long ago it was submitted

{
"disabled": false,
"memeid": "aaaaaaa",
"caption": "***__AAAAAAAA__***",
"author": {
"username": "Chew",
"bio": "#1 most depressed memerator user. pronouns: she/her",
"id": 476488167042580481,
"stats": {
"memes": 171,
"followers": 26,
"following": 20
},
"perks": {
"verified": true,
"staff": true,
"translator": false,
"pro": true
},
"permalink": "https://memerator.me/profile/476488167042580481",
"joined": "2018-10-11T15:37:03.000Z"
},
"rating": {
"average": 3.75,
"total": 4
},
"url": "https://cdn.memerator.me/K7bLRy9.jpg",
"permalink": "https://memerator.me/meme/aaaaaaa",
"timestamp": "2019-02-15T13:29:01.000Z",
"time_ago": "11 months"
}

get
Get a Meme

https://api.memerator.me/v1/meme/:id
This request gets a meme by its ID.
Request
Response
Request
Path Parameters
Meme ID
required
string
The ID of the meme you want
Response
200: OK
Response of a valid Meme
{
"disabled": false,
"memeid": "aaaaaaa",
"caption": "***__AAAAAAAA__***",
"author": {
"username": "Chew",
"bio": "#1 most depressed memerator user. pronouns: she/her",
"id": 476488167042580481,
"stats": {
"memes": 171,
"followers": 26,
"following": 20
},
"perks": {
"verified": true,
"staff": true,
"translator": false,
"pro": true
},
"permalink": "https://memerator.me/profile/476488167042580481",
"joined": "2018-10-11T15:37:03.000Z"
},
"rating": {
"average": 3.75,
"total": 4
},
"url": "https://cdn.memerator.me/K7bLRy9.jpg",
"permalink": "https://memerator.me/meme/aaaaaaa",
"timestamp": "2019-02-15T13:29:01.000Z",
"time_ago": "11 months"
}
401: Unauthorized
Response of an invalid auth key
{
"error": "Auth not valid"
}
404: Not Found
Response of a meme that doesn't exist (or is disabled, and you aren't the owner)
{
"error": "meme does not exist"
}

get
Get a Random Meme

https://api.memerator.me/v1/meme/random
Gets a random meme. Note: Not completely random?
Request
Response
Request
Response
200: OK
[a meme object]
401: Unauthorized
Response when using an invalid API key
{
"error": "Auth not valid"
}

put
Set Meme Caption

https://api.memerator.me/v1/meme/:id/caption
Change the caption of a meme you own.
Request
Response
Request
Path Parameters
:id
required
string
ID of the meme
Query Parameters
caption
required
string
The caption you want to set it to
Response
200: OK
A successful caption change response
{
"success": true,
"caption": "uwu owo nyaa",
"oldcaption": "you got got guten prankened"
}
400: Bad Request
When a known error occurs, you'll get this. It can differ, so we put a blank error in. Error will always contain something.
{
"error": ""
}
401: Unauthorized
response when using an invalid api key
{
"error": "Auth not valid"
}
403: Forbidden
Returned if you try to change the caption of a meme you don't own
{ "error": "you don't own this meme" }
404: Not Found
Raised if you try to edit a meme that doesn't exist
{ "error": 'meme does not exist' }
500: Internal Server Error
When an unknown error occurs, you'll get this.
{ "error": 'Unknown Error Changing Caption' }

get
Get Meme Comments

https://api.memerator.me/v1/meme/:id/comments
This method returns an array of comments for a specifiied meme and their author.
Request
Response
Request
Path Parameters
optional
string
Response
200: OK

put
Disable a Meme

https://api.memerator.me/v1/meme/:id/disable
Disables a meme by ID. Meme author only!
Request
Response
Request
Path Parameters
:id
required
string
Meme ID
Response
200: OK
If you did it right!
{ "success": true }
400: Bad Request
If the meme is already disabled
{ "error": "this meme is already disabled" }
401: Unauthorized
If your key is invalid or can't access the resource
{ "error": "Auth not valid" }
403: Forbidden
If you don't own the meme
{ "error": "you don't own this meme" }
404: Not Found
If the meme doesn't exist (or is disabled and you aren't the owner)
{ "error": "meme does not exist" }

put
Enable a meme

https://api.memerator.me/v1/meme/:id/enable
Exact same as disable, but for enabling
Request
Response
Request
Path Parameters
:id
required
string
The Meme ID
Response
200: OK
If you did it right!
{ "success": true }
400: Bad Request
If the meme is already enabled
{ "error": "this meme is already enabled" }
401: Unauthorized
If the API key is invalid or can't access the resource
{ "error": "Auth not valid" }
403: Forbidden
If you don't own the meme
{ "error": "you don't own this meme" }
404: Not Found
If the meme doesn't exist or it's disabled and you aren't the owner.
{ "error": "meme does not exist" }

get
Get your Rating

https://api.memerator.me/v1/meme/:id/rating
Gets your rating on a meme.
Request
Response
Request
Path Parameters
:id
required
string
the meme id
Response
200: OK
The rating
{ "rating": 5 }
401: Unauthorized
If your key isn't valid or it's not allowed to access "Ratings"
{ "error": 'Auth not valid' }
404: Not Found
If the meme doesn't exist or it's disabled and you aren't the owner.
{ "error": 'meme does not exist' }