Yo Momma Jokes
REST API for Yo Momma Jokes.
About Yo Momma Jokes
Yo Mama API is a REST API that serves "Yo Mama" jokes across seven categories: fat, old, ugly, hairy, dumb, poor, and lazy. It provides endpoints to fetch a random joke from any category or a specified one, and to retrieve all jokes across all categories or from a specified category.
A hosted version is available, described as best-effort with no reliability guarantee. The project also supports self-hosting via Docker, with configurable options including the port and a daily update check that pulls an updated jokes list from a specified GitHub repository.
The codebase was generated using AI tools. The project credits inspiration from the yomomma-apiv2 repository and an original jokes list sourced from the yomama-jokes-api repository.
Key features
- Fetch random jokes from any category or a specific category
- Retrieve all jokes across all categories or filtered by category
- Jokes organized into categories: fat, old, ugly, hairy, dumb, poor, lazy
- Self-hostable via Docker or Docker Compose
- Optional daily auto-update of jokes list from a GitHub repository
- Public hosted API available at yo-mama.tankobliterator.net
Frequently asked questions
Is there a free public API endpoint?
Yes, a public URL is available at https://yo-mama.tankobliterator.net, provided on a best-effort basis with no reliability guarantee.
Can I self-host this API?
Yes, it can be self-hosted using a provided Docker image or Docker Compose file.
What programming stack does the project use?
It runs as a Node.js application configurable via a PORT environment variable and is distributed as a Docker image.
Does the joke list update automatically?
Yes, if the FETCH_UPDATES environment variable is set to true, the app checks a GitHub repository once a day for an updated jokes list.
What categories of jokes are available?
Jokes are organized into fat, old, ugly, hairy, dumb, poor, and lazy categories.
Show your product to thousands of developers
· 100k monthly pageviews
· 7k newsletter subscribers
You might also like
Multilingual AI Zodiac
EntertainmentPersonalized daily horoscopes and zodiac insights in 100+ languages.
Official Joke
EntertainmentAPI for random and programming jokes.
Random Dad Joke
EntertainmentAPI for largest selection of dad jokes on the internet.
Random Useless Facts
EntertainmentGet useless, but true facts.
Techy
EntertainmentJSON and Plaintext API for tech-savvy sounding phrases.
World Fun Facts (RapidAPI)
EntertainmentFun and interesting facts with multi-language support.
