JSON API for a random meme scraped from reddit.
API Link : https://reddit-meme-api.herokuapp.com/
Example Response:
{
"code": 200,
"post_link": "https://redd.it/kadq22",
"subreddit": "AdviceAnimals",
"title": "The struggle is real during these trying times.",
"url": "https://i.redd.it/di9suwomhc461.jpg",
"ups": 22471,
"author": "bobbydigital_ftw",
"spoilers_enabled": true,
"nsfw": false,
"image_previews": [
"https://preview.redd.it/di9suwomhc461.jpg?width=108&crop=smart&auto=webp&s=8c033387866f4a2ff608abf3f8cce8507518866c",
"https://preview.redd.it/di9suwomhc461.jpg?width=216&crop=smart&auto=webp&s=85ea6bc35101b9fd76bbbd1c17a1df3889e21e62",
"https://preview.redd.it/di9suwomhc461.jpg?width=320&crop=smart&auto=webp&s=263b77afd27714f155a94f15578b042f968cc688"
]
}Note: While using the API always confirm that the response for
"code"is 200, else there is some error!!!
In order to get multiple memes in a single request specify the count with the following endpoint.
Endpoint: /{count}
Example: https://reddit-meme-api.herokuapp.com/2
Response:
{
"code": 200,
"count": 2,
"memes": [
{
"post_link": "https://redd.it/kgvsku",
"subreddit": "MemeEconomy",
"title": "Easy Investment",
"url": "https://i.redd.it/9xsdu34x0d661.jpg",
"ups": 7439,
"author": "KingEmperio",
"spoilers_enabled": true,
"nsfw": false,
"image_previews": [
"https://preview.redd.it/9xsdu34x0d661.jpg?width=108&crop=smart&auto=webp&s=f24bfe89b3946b4c9fe8d37d475582067953cafd",
"https://preview.redd.it/9xsdu34x0d661.jpg?width=216&crop=smart&auto=webp&s=ce659a23b9983ac821b0a0a2bfe4fb2243750e08",
"https://preview.redd.it/9xsdu34x0d661.jpg?width=320&crop=smart&auto=webp&s=c3bfb292653ab689cc0b9ce6b20371e320fc7020",
"https://preview.redd.it/9xsdu34x0d661.jpg?width=640&crop=smart&auto=webp&s=96d04ad834466addf1a9482a17a6a1d92e5f86dd",
"https://preview.redd.it/9xsdu34x0d661.jpg?width=960&crop=smart&auto=webp&s=e0d74c2cf387326927838cd777b54eee7eb83462",
"https://preview.redd.it/9xsdu34x0d661.jpg?width=1080&crop=smart&auto=webp&s=b3dea7a7fc38dbfd2764a8d08af0fdf449e6e3d8"
]
},
{
"post_link": "https://redd.it/kgfk5v",
"subreddit": "MemeEconomy",
"title": "How much is this meme template worth?",
"url": "https://i.redd.it/2j5r9myud7661.jpg",
"ups": 127,
"author": "ABC0012300",
"spoilers_enabled": true,
"nsfw": false,
"image_previews": [
"https://preview.redd.it/2j5r9myud7661.jpg?width=108&crop=smart&auto=webp&s=879677b7b53b9612b35d04b7182edae85e778599",
"https://preview.redd.it/2j5r9myud7661.jpg?width=216&crop=smart&auto=webp&s=f933ed1d55d0effbd196afd52cb2e755e683a9c1",
"https://preview.redd.it/2j5r9myud7661.jpg?width=320&crop=smart&auto=webp&s=e921fb4b46920bc72efba8a477ced020a8c16c49"
]
}
]
}Not all memes have image preview so it is suggested to use the
"url"endpoint's result
By default the API grabs a random meme from 'memes', 'dankmemes', 'AdviceAnimals','MemeEconomy','me_irl', 'ComedyCemetery' and 'terriblefacebookmemes'subreddits. To provide your own custom subreddit use the following endpoint.
Endpoint: /{subreddit}
Example: https://reddit-meme-api.herokuapp.com/wholesomememes
Response:
{
"code": 200,
"post_link": "https://redd.it/kgx7gq",
"subreddit": "wholesomememes",
"title": "Good looking cookiea",
"url": "https://i.redd.it/hn2axo0zed661.jpg",
"ups": 36563,
"author": "the_mean_guy_is_here",
"spoilers_enabled": true,
"nsfw": false,
"image_previews": [
"https://preview.redd.it/hn2axo0zed661.jpg?width=108&crop=smart&auto=webp&s=e3cf46f9200d4d9ad71ea4e8a12741b1c83aa7a9",
"https://preview.redd.it/hn2axo0zed661.jpg?width=216&crop=smart&auto=webp&s=acee023286903da15e977b2cc62346529dec359b",
"https://preview.redd.it/hn2axo0zed661.jpg?width=320&crop=smart&auto=webp&s=b7e9973afcb785a821b8dfd9f2e20763465653a1",
"https://preview.redd.it/hn2axo0zed661.jpg?width=640&crop=smart&auto=webp&s=695d53f60ae2e7bb353a85a26997175904c8fbe6"
]
},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: /{subreddit}/{count}
Example: https://reddit-meme-api.herokuapp.com/wholesomememes/2
Response:
{
"code": 200,
"count": 2,
"memes": [
{
"post_link": "https://redd.it/kgx7gq",
"subreddit": "wholesomememes",
"title": "Good looking cookiea",
"url": "https://i.redd.it/hn2axo0zed661.jpg",
"ups": 36563,
"author": "the_mean_guy_is_here",
"spoilers_enabled": true,
"nsfw": false,
"image_previews": [
"https://preview.redd.it/hn2axo0zed661.jpg?width=108&crop=smart&auto=webp&s=e3cf46f9200d4d9ad71ea4e8a12741b1c83aa7a9",
"https://preview.redd.it/hn2axo0zed661.jpg?width=216&crop=smart&auto=webp&s=acee023286903da15e977b2cc62346529dec359b",
"https://preview.redd.it/hn2axo0zed661.jpg?width=320&crop=smart&auto=webp&s=b7e9973afcb785a821b8dfd9f2e20763465653a1",
"https://preview.redd.it/hn2axo0zed661.jpg?width=640&crop=smart&auto=webp&s=695d53f60ae2e7bb353a85a26997175904c8fbe6"
]
},
{
"post_link": "https://redd.it/kh1svx",
"subreddit": "wholesomememes",
"title": "yes yes yes",
"url": "https://i.redd.it/upypw6gtke661.jpg",
"ups": 1945,
"author": "patrickpotato07",
"spoilers_enabled": true,
"nsfw": false,
"image_previews": [
"https://preview.redd.it/upypw6gtke661.jpg?width=108&crop=smart&auto=webp&s=fea3a1b77bf574dd42d9c890c56e4b99f27f3002",
"https://preview.redd.it/upypw6gtke661.jpg?width=216&crop=smart&auto=webp&s=6d79463760e9a53be595dd95fe249390c574a03f",
"https://preview.redd.it/upypw6gtke661.jpg?width=320&crop=smart&auto=webp&s=8738d682e8059ec5ef0cb1cecf980888cfdb33f2",
"https://preview.redd.it/upypw6gtke661.jpg?width=640&crop=smart&auto=webp&s=70a37d8e5d9f9020942f2f85f30cb393f4e59f4f"
]
}
]
}