README.md

”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:

{
    "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:

{
    "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/<quote_id> will return specific quote for the given quote_id. Like: /quoteId/k3fhzAKsvCeuFhXPHPQcnT.

Example response:

{
    "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