”It’s not who I am underneath, but what I do that defines me.” – Batman
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