World's best quotes API

TheySaidSo Famous Quotes API


We have a huge collection of quotes in our database. And our best Quotes API gives easy way to access the data. Note if you are using our public API / quotes from our website an attribution link back to is required. If you don't want to display attribution please sign up for the private API. Here is the code you can cut and paste to provide attribution.

<span style="z-index:50;font-size:0.9em;"><img src="" height="20" width="20" alt=""/><a href="" title="Powered by quotes from" style="color: #9fcc25; margin-left: 4px; vertical-align: middle;"></a></span>

Which will translate to something like this in your webpage. Nothing too big. Just a small token of appreciation from you for our service.

API End Points

The end point for connecting, if you subscribe directly from us use this endpoint. 


The API's marked as public below can be accessed without any authentication.

Here is an example of requesting an inspiring quote of the day using curl.

curl -v  -i -X GET  

For the API's that are pirvate currently we support API Key based authentication. Please set a request header 'X-TheySaidSo-Api-Secret' with value of your API key. Alternatively you can also pass api_key= as a request parameter, though we strongly discourage this mode of passing the key.

Here is an example of requesting for a random quote using curl.

curl -v  -i -X GET -H 'X-TheySaidSo-Api-Secret: <your_api_key>'  

Here is an example of requesting for a random quote using passing api_key as a parameter.<your_api_key>


Want it in JSON format? Just append .json to the query like below. Alternatively you send a http accept header indicating you expect json response. Mashape by default does this so if you are using Mashape the following is not applicable.


Just append .xml to the query to get the result in XML format.


Want it in javascript friendly format. We support JSONP format as well. Append .js to your request.


Rate Limit

To maintain our service level we rate limit (10 API calls per hour) our public API usage. If you sign up and use the private api key or any of the supported authentication schemes this limit is increased to according to the service level of your plan.

Quote of the day public ratelimited

To get the quote of the day use the following api call.


Here is an example of using this from your browser. Click on the url below to test.

Here is an example using curl.

curl -v  -i -X GET

Here is an example using curl, if you are a subscriber and have an API key.

curl -v  -i -X GET  -H 'X-Theysaidso-Api-Secret: <api_key>'

QOD Categories public ratelimited

We have more than 15 categories (5 categories published now. 10 categories are being added) for our Quote of the Day service. To get the all the categories in the QOD system, use the following API.


Here is an example using curl.

curl -v  -i -X GET

QOD for a specific category public ratelimited

Here is example of requesting a Management Quote of the day!


Here is an example using curl.

curl -v  -i -X GET

Random Quote private ratelimited

Want a random quote from our system? Call the following API.


Quote with length restrictions private ratelimited

Want a quote that fits your display profile? You can use any of the following combination to pick the best quote size.

The following returns a quote with at least 100 char length.


The following returns a quote with maximum of 100 char length i.e. 0-100 char length quote.


The following returns a quote with a length between 100 chars to 300 chars.


Categories private ratelimited

We categorize the quotes with tags and we have lot of categories of quotes in our system. To browse the categories in the system, use the following api. Adjust the start parameter to browse.


If you need a random quote from any of the above 500+ categories, just specify the category in you query.


Author private ratelimited

Our quotes database has quotes from more than 100,000 authors. No where else you have this much variety. You can browse the author names by adjusting the start parameter.


If you want a random quote by an author, here is how you get it.


Combination Example


Adding Quotes private ratelimited

You can also programmatically add quotes to our system using our API. Use REST PUT to add a new quote. This will be your private quote in the system.


Random Quote Image private ratelimited

We have beautiful curated quotes as images. You can access them easily using our API and show them in your websites or Applications. To get a random quote image use the following:


Random Quote Image from a category private ratelimited

To get a random quote image from a particular category use the following:


Random Quote Image from an Author private ratelimited

To get a random quote image from a particular author use the following:

	var getQuoteCategories = {
		type: 'get',
		url: '',
		dataType: 'json',
		success: function(data) {
				console.log('Pulled from API!!');
	         error: function() {
	                      console.log('Something did not happen as intended')
	         beforeSend: function(xhr) {
}); // end of document.ready


The private API methods are accessible only through subscription. Drop us a note (Choose About > Contact) if you have any questions.


They Said So Quotes Ultra


No contracts. Anytime cancellation.
1 API Key
8,000 API Calls/Day

They Said So Quotes Premium


No contracts. Anytime cancellation.
1 API Key
2,500 API Calls / Day

They Said So Basic


No contracts. Anytime cancellation.
1 API Key
1000 API Calls / Day

If you don't want to subscribe directly from us, you can also get access through Mashape. Click the button below to visit our API at Mashape and subscribe from Mashape.