This is a REST-based API, with only a handful of endpoints, all delivering JSON responses. Each successful API request will either return a single quote (as a single JSON object) or a set of quotes (as an array of JSON objects).
The following endpoints (routes) are available:
/api/v1/quote/:id Returns the data for the quote with a particular id (as a single JSON object). Ids run from 1 up to (and including) 1122.
/api/v1/random Returns the data for a random quote (as a single JSON object).
/api/v1/random/favorite Returns the data for a random favorite quote (as a single JSON object). Favorite quotes are quotes that are a bit more canonical and less obscure.
/api/v1/search/:searchterms Returns the data for quotes that contains the search terms (as an array of JSON objects). The search is case insensitive. If no quotes are found an empty array is returned.
A JSON object of a quote has the following information:
{
"id": "26",
"quote": "Obviously you're not a golfer.",
"quote_with_quotes": "“Obviously you're not a golfer.”",
"person": "The Dude",
"slug": "golfer",
"url": "https://www.thebiglebow.ski/golfer",
"favorite": "1",
"still": "https://www.thebiglebow.ski/stills/26.jpg",
"still_with_text": "https://www.thebiglebow.ski/stills/26-with-text.jpg",
"still_thumb_120": "https://www.thebiglebow.ski/stills/26-thumb-120.jpg",
"still_thumb_80": "https://www.thebiglebow.ski/stills/26-thumb-80.jpg",
"still_for_facebook": "https://www.thebiglebow.ski/stills/26-for-social.jpg",
"still_for_twitter": "https://www.thebiglebow.ski/stills/26-for-social.jpg",
"still_for_instagram": "https://www.thebiglebow.ski/stills/26-for-instagram.jpg"
}Some notes about the different fields:
quote_with_quotes is exactly the same as quote, but has opening and closing quotation marks added.
person is the character who has uttered the quote.
Not all quotes have a slug. If they don't have one, then they will return null for this field.
url is where you can view the quote on this website.
favorite can be 1 (if the quote is considered to be a favorite) and 0 (if it isn't).
still is a link to a 1920x1038 pixel JPG file of the moment in the movie that this quote is uttered.
still_with_text is a link to a 1920x1038 pixel JPG file of the moment in the movie that this quote is uttered with the quote and character superimposed over the still. This is ideal for a desktop background.
still_thumb_120 is a link to a 120x65 pixel JPG file of the moment in the movie that this quote is uttered, and still_thumb_80 is a 80x43 pixel JPG file of the same.
still_for_facebook and still_for_twitter are links to 1200x628 pixel JPG files of the moment in the movie that this quote is uttered. These images are used for Facebook and Twitter cards when sharing the link on these platforms.
still_for_instagram is a link to a square 1038x1038 pixel JPG file of the moment in the movie that this quote is uttered with the quote and character superimposed over the still. This is an ideal image to post on Instagram.
For all images, it is preferred that you copy the image to your computer or server, rather than hotlinking the image.