meme-api.herokuapp.com has stopped working
Please update your apps to the new Domain meme-api.com to continue using the API
JSON API for a random meme scraped from reddit.
API Link : https://meme-api.com/gimme
Example Response:
{
"postLink": "https://redd.it/jiovfz",
"subreddit": "dankmemes",
"title": "*leaves call*",
"url": "https://i.redd.it/f7ibqp1dmiv51.gif",
"nsfw": false,
"spoiler": false,
"author": "Spartan-Yeet",
"ups": 3363,
// preview images of the meme sorted from lowest to highest quality
"preview": [
"https://preview.redd.it/f7ibqp1dmiv51.gif?width=108&crop=smart&format=png8&s=02b12609100c14f55c31fe046f413a9415804d62",
"https://preview.redd.it/f7ibqp1dmiv51.gif?width=216&crop=smart&format=png8&s=8da35457641a045e88e42a25eca64c14a6759f82",
"https://preview.redd.it/f7ibqp1dmiv51.gif?width=320&crop=smart&format=png8&s=f2250b007b8252c7063b8580c2aa72c5741766ae",
"https://preview.redd.it/f7ibqp1dmiv51.gif?width=640&crop=smart&format=png8&s=6cd99df5e58c976bc115bd080a1e6afdbd0d71e7"
]
}In order to get multiple memes in a single request specify the count with the following endpoint.
Endpoint: /gimme/{count}
Example: https://meme-api.com/gimme/2
Response:
{
"count": 2,
"memes": [
{
"postLink": "https://redd.it/jictqq",
"subreddit": "dankmemes",
"title": "Say sike",
"url": "https://i.redd.it/j6wu6o9ncfv51.gif",
"nsfw": false,
"spoiler": false,
"author": "n1GG99",
"ups": 72823,
"preview": [
"https://preview.redd.it/j6wu6o9ncfv51.gif?width=108&crop=smart&format=png8&s=3b110a4d83a383b7bfebaf09ea60d89619cddfb3",
"https://preview.redd.it/j6wu6o9ncfv51.gif?width=216&crop=smart&format=png8&s=ba5808992b3245a6518dfe759cbe4af24e042f2d",
"https://preview.redd.it/j6wu6o9ncfv51.gif?width=320&crop=smart&format=png8&s=7567bb64e639223e3603236f774eeca149551313"
]
},
{
"postLink": "https://redd.it/jilgdw",
"subreddit": "dankmemes",
"title": "I forgot how hard it is to think of a title",
"url": "https://i.redd.it/jk12rq8nrhv51.jpg",
"nsfw": false,
"spoiler": false,
"author": "TheRealKyJoe01",
"ups": 659,
"preview": [
"https://preview.redd.it/jk12rq8nrhv51.jpg?width=108&crop=smart&auto=webp&s=d5d3fe588ccff889e61fca527c2358e429845b80",
"https://preview.redd.it/jk12rq8nrhv51.jpg?width=216&crop=smart&auto=webp&s=b560b78301afd8c173f8c702fbd791214c1d7f61",
"https://preview.redd.it/jk12rq8nrhv51.jpg?width=320&crop=smart&auto=webp&s=3cd427240b2185a3691a818774214fd2a0de124d",
"https://preview.redd.it/jk12rq8nrhv51.jpg?width=640&crop=smart&auto=webp&s=1142cc19a746b8b5d8335679d1d36127f4a677b9"
]
}
]
}By default the API grabs a random meme from 'memes', 'dankmemes', 'me_irl' subreddits. To provide your own custom subreddit use the following endpoint.
Endpoint: /gimme/{subreddit}
Example: https://meme-api.com/gimme/wholesomememes
Response:
{
"postLink": "https://redd.it/jhr5lf",
"subreddit": "wholesomememes",
"title": "Every time I visit",
"url": "https://i.redd.it/hsyyeb87v7v51.jpg",
"nsfw": false,
"spoiler": false,
"author": "pak_choy",
"ups": 1660,
"preview": [
"https://preview.redd.it/hsyyeb87v7v51.jpg?width=108&crop=smart&auto=webp&s=b76ddb91f212b2e304cad2cd9c5b71a6ddca832c",
"https://preview.redd.it/hsyyeb87v7v51.jpg?width=216&crop=smart&auto=webp&s=2bd0b104fd0825afc15d9faa7977c6801e6dae0b",
"https://preview.redd.it/hsyyeb87v7v51.jpg?width=320&crop=smart&auto=webp&s=7625c69e144c9cb187dd0be88f541918aca5cedd",
"https://preview.redd.it/hsyyeb87v7v51.jpg?width=640&crop=smart&auto=webp&s=e933f956e01d62810e68f12ed8b26a8178ecbb0f"
]
}In order to get a custom number of memes from a specific subreddit provide the name of the subreddit and the count in the following endpoint.
Endpoint: /gimme/{subreddit}/{count}
Example: https://meme-api.com/gimme/wholesomememes/2
Response:
{
"count": 2,
"memes": [
{
"postLink": "https://redd.it/ji1riw",
"subreddit": "wholesomememes",
"title": "It makes me feel good.",
"url": "https://i.redd.it/xuzd77yl8bv51.png",
"nsfw": false,
"spoiler": false,
"author": "polyesterairpods",
"ups": 306,
"preview": [
"https://preview.redd.it/xuzd77yl8bv51.png?width=108&crop=smart&auto=webp&s=9a0376741fbda988ceeb7d96fdec3982f102313e",
"https://preview.redd.it/xuzd77yl8bv51.png?width=216&crop=smart&auto=webp&s=ee2f287bf3f215da9c1cd88c865692b91512476d",
"https://preview.redd.it/xuzd77yl8bv51.png?width=320&crop=smart&auto=webp&s=88850d9155d51f568fdb0ad527c94d556cd8bd70",
"https://preview.redd.it/xuzd77yl8bv51.png?width=640&crop=smart&auto=webp&s=b7418b023b2f09cdc189a55ff1c57d531028bc3e"
]
},
{
"postLink": "https://redd.it/jibifc",
"subreddit": "wholesomememes",
"title": "It really feels like that",
"url": "https://i.redd.it/vvpbl29prev51.jpg",
"nsfw": false,
"spoiler": false,
"author": "lolthebest",
"ups": 188,
"preview": [
"https://preview.redd.it/vvpbl29prev51.jpg?width=108&crop=smart&auto=webp&s=cf64f01dfaca5f41c2e87651e4b0e321e28fa47c",
"https://preview.redd.it/vvpbl29prev51.jpg?width=216&crop=smart&auto=webp&s=33acdf7ed7d943e1438039aa71fe9295ee2ff5a0",
"https://preview.redd.it/vvpbl29prev51.jpg?width=320&crop=smart&auto=webp&s=6a0497b998bd9364cdb97876aa54c147089270da",
"https://preview.redd.it/vvpbl29prev51.jpg?width=640&crop=smart&auto=webp&s=e68fbe686e92acb5977bcfc24dd57febd552afaf",
"https://preview.redd.it/vvpbl29prev51.jpg?width=960&crop=smart&auto=webp&s=1ba690cfe8d49480fdd55c6daee6f2692e9292e7",
"https://preview.redd.it/vvpbl29prev51.jpg?width=1080&crop=smart&auto=webp&s=44852004dba921a17ee4ade108980baab242805e"
]
}
]
}