Pool-Of-Tears / SuperHero-Quotes

Restful JSON API consisting huge collection of Marvel & DC SuperHeros and Supervillains quotes!
https://superhero-quotes.herokuapp.com/
MIT License
15 stars 1 forks source link
dcuniverse flask-api flask-restful marvel marvel-api rest-api superhero-api superhero-quotes superheroes supervillains-quotes

”It’s not who I am underneath, but what I do that defines me.” – Batman

made-with-python License: MIT PRs Welcome Code style: black API status

An API consisting huge collection of handpicked Marvel & DC SuperHeros and Supervillains quotes!:zap:

Base API URL

https://superhero-quotes.herokuapp.com/

Click below to view endpoints

reveal endpoints - `/grab?banner=mcu` or `/grab?banner=dcu`: Returns 10 random quote for the given banner. You can also fetch more than 10 quote at a time by passing `size` parameter, like: `/grab?banner=mcu&size=2` will return two quotes from Marvel's collection. - Note: Max size limit is `50` (fifty) **Example response**: ```json { "StatusCode": 200, "Banner": "Marvel Cinematic Universe (MCU)", "TotalQuotes": 2, "Items": [ { "id": "6SYjJebRR8fCF9SnvFZBKQ", "data": { "author": "Iron Man", "quote": "You know what, give me a break, Steve. I just got hit in the head with a Hulk." } }, { "id": "2cquLZiJsUbg5jtQrdwLkM", "data": { "author": "Thanos", "quote": "You have my respect, stark. When I'm done, half of humanity will still be alive. I hope they remember you." } } ] } ``` - `/random`: Will return single randomly chosen quote from either Marvel or DC collection. **Example response**: ```json { "StatusCode": 200, "Banner": "DC Universe (DCU)", "Stuff": { "id": "c4ZuUeSUzjGiCEVUmsrYWN", "data": { "author": "Wonder Woman", "quote": "Death is necessary. It is part of life, and if we say life is a blessing, we must say that death is a blessing, as well." } } } ``` - `/quoteId/` will return specific quote for the given `quote_id`. Like: `/quoteId/k3fhzAKsvCeuFhXPHPQcnT`. **Example response**: ```json { "StatusCode": 200, "Stuff": { "id": "k3fhzAKsvCeuFhXPHPQcnT", "data": { "author": "The Joker", "quote": "The pen, is truly mightier than the sword! " } } } ```

Collection updates:

Quotes collection gets updated frequently from new movie releases by both Marvel & DCU or whenever i have some great findings! Please checkout CHANGES.md file to stay in loop with new additions :)

Contribute

Have an idea? Found a bug? Create a new issue with detailed description.

License

MIT © Stɑrry Shivɑm