api. theysaidso .com - World's best quotes API

Quotes API

Public API

Largest Quotes database in the world

We have more than 1 million+ quotes in our quotes database, the largest such database in the world. 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 theysaidso.com 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="http://theysaidso.com/branding/theysaidso.png" height="20" width="20" alt="theysaidso.com"/><a href="http://theysaidso.com" title="Powered by quotes from theysaidso.com" style="color: #9fcc25; margin-left: 4px; vertical-align: middle;">theysaidso.com</a></span>
          

API End Points

The following end points are supported. If you subscribe directly from us use this endpoint.

                 http://api.theysaidso.com/
          

If you subscribe via Mashape use the following endpoint.

                 http://theysaidso.p.mashape.com/
          

Quote of the day

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

http://<endpoint>/qod

Formats

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.

http://api.theysaidso.com/qod.json

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

http://api.theysaidso.com/qod.xml

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

http://api.theysaidso.com/qod.js

QOD Categories

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.

http://<endpoint>/qod/categories

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

http://<endpoint>/qod?category=management 

Rate Limit

To maintain our service level we rate limit (10 API calls per hour) our public API usuage. If you sign up and use the private api key this limit is increased to according you the service level of your plan. If you use Mashape use the Mashape key in the header. You can see examples in the Mashape documentation page for our API.

http://<endpoint>/qod?api_key=<key>

Private API

The following functionalities and API methods are accessible only through subscription. Drop us a note (Choose About > Contact) if you have any questions. Subscribe to our API access @ Mashape.

MOST
POPULR

Mashape Ultra

$24.99/mo

No contracts. Anytime cancellation.
1 API Key
5,000 API Calls/Day
$0.001 per extra API call
All the Mashape features.
Usage Reports

Mashape Premium

$9.99/mo

No contracts. Anytime cancellation.
1 API Key
1,500 API Calls / Day
$0.01 per extra API call
All the Mashape features.
Usage Reports

Mashape Basic

$4.99/mo

No contracts. Anytime cancellation.
1 API Key
500 API Calls / Day
$0.01 per extra API call
All the Mashape features.
Usage Reports

Mashape Freemium

Free!

No contracts. Anytime cancellation.
1 API Key
5 API Calls / Day
$0.02 per extra API call
All the Mashape features.
Usage Reports

Random Quote

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

http://<endpoint>/quote?api_key=<key>

Quote with length restrictions

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.

 http://<endpoint>/quote?minlength=100&api_key=<key> 

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

 http://<endpoint>/quote?maxlength=100&api_key=<key> 

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

 http://<endpoint>/quote?minlength=100&maxlength=300&api_key=<key> 

Categories

We have more than 500 categories of quotes in our system. To get the all the categories in the system, use the following api.

http://<endpoint>/categories

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

http://<endpoint>/quote?category=<category>&api_key=<key> 

Author

Our quotes database has quotes from more than 100,000 authors. No where else you have this much variety. If you want a random quote by an author, here is how you get it.

http://<endpoint>/quote?author=<author>&api_key=<key> 

Combination Example

http://<endpoint>/quote?minlength=100&category=<category>&author=<author>&api_key=<key> 

Bible Verses

Many of our clients requested the same easy to use style API access to bible verses. So here is how you can get bible verses via our API. All the bible API's are public use but rate limited to 10 calls per hour for a client. If you have an API key this limit is raised to 5000 calls / hour.

Verse of the day

http://<endpoint>/bible/vod&api_key=<key> 

Random Verse

http://<endpoint>/bible/verse?api_key=<key> 

Random verse with book restriction. The following API will return any random verse from book 3(aka. Leviticus)

http://<endpoint>/bible/verse.json?api_key=<key>&book=3

Random verse with book & chapter restriction. The following API will return any random verse from book 3(aka. Leviticus) and chapter 2

http://<endpoint>/bible/verse.json?api_key=<key>&book=3&chapter=2