Skip to content
This repository has been archived by the owner on Nov 9, 2023. It is now read-only.

Restful JSON API consisting huge collection of Marvel & DC SuperHeros and Supervillains quotes!

License

Notifications You must be signed in to change notification settings

Pool-Of-Tears/SuperHero-Quotes

Repository files navigation

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

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