{"id":17319896,"url":"https://github.com/saransh-cpp/memeboi","last_synced_at":"2025-09-03T21:32:06.396Z","repository":{"id":47146173,"uuid":"365273768","full_name":"Saransh-cpp/MemeBoi","owner":"Saransh-cpp","description":"A meme API written with javascript, node.js, and express.js that scraps meme links from Reddit's API (Though the API was intended to fetch memes, it can be used to fetch images from any subreddit) (Check out the README for usage instructions). ","archived":false,"fork":false,"pushed_at":"2021-09-11T17:50:32.000Z","size":88,"stargazers_count":1,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-19T07:51:07.958Z","etag":null,"topics":["api","api-rest","express","express-js","javascript","meme","meme-generator","memes","node","node-js","reddit","reddit-api","reddit-scraper","server","subreddit"],"latest_commit_sha":null,"homepage":"https://meme-boii.herokuapp.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Saransh-cpp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-07T15:16:37.000Z","updated_at":"2022-03-17T17:57:38.000Z","dependencies_parsed_at":"2022-09-03T23:11:37.519Z","dependency_job_id":null,"html_url":"https://github.com/Saransh-cpp/MemeBoi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saransh-cpp%2FMemeBoi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saransh-cpp%2FMemeBoi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saransh-cpp%2FMemeBoi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saransh-cpp%2FMemeBoi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Saransh-cpp","download_url":"https://codeload.github.com/Saransh-cpp/MemeBoi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231919747,"owners_count":18445975,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-rest","express","express-js","javascript","meme","meme-generator","memes","node","node-js","reddit","reddit-api","reddit-scraper","server","subreddit"],"created_at":"2024-10-15T13:27:56.681Z","updated_at":"2024-12-30T22:23:25.436Z","avatar_url":"https://github.com/Saransh-cpp.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MemeBoi\n\nA meme API written with javascript, node.js and express.js that scraps meme links from reddit's API. \n\n(Though the API was intended to fetch memes, it can be used to fetch images from any subreddit. For example - `http://meme-boii.herokuapp.com/Awww/10` will give you cute images of dogs and cats rather than memes.)\n\n# Usage\n\n1. Open the [deployment](https://meme-boii.herokuapp.com/).\n\n2. Add `subreddit` you want to search after the URL, for example `https://meme-boii.herokuapp.com/dankmemes` (won't work yet) \n\n(Note: Not all subreddits are supported, if you find an empty json object after making several requests on a subreddit then it most probably is not supported. Some of the supported ones are `memes`, `dankmemes`, `pewdiepie` etc.).\n\n3. Add the total number of memes out of which 1 random meme will be selected, for example `https://meme-boii.herokuapp.com/dankmemes/10`.\n\n4. Boom! Keep refreshing to get a new meme (a URL obviously). The object returned will be of the form -\n```JSON\n{\n  \"url\": \"some_image_url_here\"\n}\n```\n\n5. Add this API link wherever you want to summon memes (app, website, desktop app etc.).\n\n# How it works\n\n- This API uses the `reddit API` to fetch number of memes specified by the user with the subreddit.\n\n- Then it chooses a random meme and provides you with its link!\n\n# Tips\n\n- Keep the number of total memes less, more memes = more time to fetch one.\n\n- Always use a `try` and `catch` block.\n\n- All contributions are welcome:). \n\n# Installing locally\n\n1. `Fork` and `clone` the repository.\n\n2. Navigate to the `MemeBoi` repository using -\n```sh\ncd MemeBoi\n```\n3. Run the following command to install dependencies - \n``` sh\nnpm install\n```\n4. To start the server run -\n```sh\nnpm start\n```\n5. To run the example located at `./useApi.js` execute -\n```sh\nnode useApi.js\n```\n\n# Projects that use this API\n\n- [MemeShare](https://www.github.com/Saransh-cpp/MemeShare)\n\nAn app made with Kotlin that fetches and displays memes filtered by category.\n\nLet me know if any of your projects use this API, I'll be happy to add them here (You can do so much more than just memes using this API! And I'll appreciate if you can provide a link to this repository in the project that uses this API).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaransh-cpp%2Fmemeboi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaransh-cpp%2Fmemeboi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaransh-cpp%2Fmemeboi/lists"}