Quotes API
The Quotes API provides tens of thousands of carefully curated, aphoristic quotes from famous people throughout history. All quotes are pre-vetted and pre-processed by our data team to ensure quality and selected specifically for their memorable and thought-provoking nature.
Available endpoints:
- /v2/quotes - Get quotes with pagination support (deterministic order)
- /v2/randomquotes - Get random quotes
- /v2/quoteoftheday - Get today's quote (same quote all day)
- /v2/quoteauthors - Get list of authors with multiple aphoristic quotes (premium only)
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 329ms | 371ms | 426ms | 703ms | 1220ms |
Didn't find what you were looking for? Suggest an improvement
/v2/quotes GET
https://api.api-ninjas.com/v2/quotes
Returns high-quality quotes with advanced filtering by categories (include/exclude), author, work, and pagination support. Returns quotes in deterministic order. For random quotes, use /v2/randomquotes or /v2/quoteoftheday.
The following categories are available:
wisdomphilosophylifetruthinspirationalrelationshipslovefaithhumorsuccesscouragehappinessartwritingfearnaturetimefreedomdeathleadership
Parameters
categoriesoptionalComma-separated list of categories to include in results (results will match all of the categories). Example:
categories=wisdom,successexclude_categoriesoptionalComma-separated list of categories to exclude from results (results will not match any of the categories). Example:
exclude_categories=love,philosophyauthoroptionalFilter quotes by author name (partial match supported). Example:
author=EinsteinworkoptionalFilter quotes by work title (partial match supported). Example:
work=Warlimitpremium onlyNumber of results to return. Must be between
1and100. Default is1.offsetpremium onlyNumber of results to skip for pagination. Default is
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
quoteThe quote text.
authorThe author of the quote.
workThe work/book from which the quote originates (if available).
categoriesArray of categories associated with the quote.
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v2/quotes?categories=success%2CwisdomHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
7
8
9
10
11
12
[
{
"quote": "The road to success begins with knowing what you need to know and why",
"author": "Savania China",
"work": "",
"categories": [
"success",
"wisdom",
"inspirational"
]
}
]Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v2/quotes?categories=success,wisdom" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
/v2/randomquotes GET
https://api.api-ninjas.com/v2/randomquotes
Returns random high-quality quotes with advanced filtering by categories (include/exclude), author, and work. Each request returns different random quotes.
The categories available are the same as for /v2/quotes.
Parameters
categoriesoptionalComma-separated list of categories to include in results (results will match all of the categories). Example:
categories=wisdom,successexclude_categoriesoptionalComma-separated list of categories to exclude from results (results will not match any of the categories). Example:
exclude_categories=love,philosophyauthoroptionalFilter quotes by author name (partial match supported). Example:
author=EinsteinworkoptionalFilter quotes by work title (partial match supported). Example:
work=Warlimitpremium onlyNumber of random results to return. Must be between
1and100. Default is1.
Response
Same response format as /v2/quotes
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v2/randomquotes?categories=success,wisdomHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
7
8
9
10
11
12
[
{
"quote": "Always remember, success leaves clues.",
"author": "John Patrick Hickey",
"work": "On The Journey To Achievement",
"categories": [
"success",
"wisdom",
"inspirational"
]
}
]/v2/quoteoftheday GET
https://api.api-ninjas.com/v2/quoteoftheday
Returns a single aphoristic quote for the current day. The same pre-vetted, high-quality quote is returned for all requests on the same day, and changes each day. Perfect for displaying on your website or app. No filtering parameters are available for this endpoint to ensure everyone sees the same quote of the day.
Response
Same response format as /v2/quotes (always returns a single quote)
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v2/quoteofthedayHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
7
8
9
10
11
12
13
[
{
"quote": "Goals want to realize themselves.",
"author": "Zoltan Andrejkovics",
"work": "The Invisible Game: The Mindset of a Winning Team",
"categories": [
"inspirational",
"philosophy",
"wisdom",
"success"
]
}
]/v2/quoteauthors GETPremium subscriptions only
https://api.api-ninjas.com/v2/quoteauthors
Returns a list of authors who have at least 2 aphoristic quotes in the database. Authors are sorted by the number of quotes (descending) and then alphabetically by name. Default returns 100 authors (maximum 500 per request).
Parameters
limitoptionalMaximum number of authors to return. Must be between
1and500. Default is100.offsetoptionalNumber of authors to skip. Used for pagination. Default is
0.
Response
Returns an array of author names as strings.
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v2/quoteauthorsHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
1
2
3
4
5
6
[
"Albert Einstein",
"Mark Twain",
"William Shakespeare",
...
]