Some time back we wrote a minimal Quotes WordPress plugin that'd do nothing other than render a single quote into a WordPress website. While the nature of the plugin was exceedingly simple, the API itself is quite complete, and it provides quote data to our social media and marketing system. We've recently migrated the API over to its new home in preparation for our new platform and, as always, it's available to all our current and former clients for use in any manner that floats their boat.
While the source is one of a few quotes databases that we use, it's one of the more comprehensive. This article describes (in brief) how to access the data.
Data may be queried by quote ID (for a single quote), or by search term, author, or genre. Regardless of what query is made, the data array returned in each case includes identical fields. The endpoint in all cases is as follows:
An API Key is required, and an optional
number parameter may be supplied for pagination purposes. If searching results the
search type must be provided:
search (for text searches),
author_slug), or by genre (
genre_slug). If no
search type is provided, the
browse type is assumed.
Returning a Single Quote
A single quote may be returned as follows:
quotes.json?apikey=xxxxx&id=gY. The result:
The image referenced is a branded quote on our server (with its parent directory). The
genre_slug in the
info array are provided for search purposes.
Searching by Text, Author, Genre, or Browsing
In all search cases, the results are returned in an identical manner. Example queries are as follows:
quotes.json?apikey=xxx&type=search&search=money (searching for text "money").
quotes.json?apikey=xxx&type=author&search=mark-twain (searching Mark Twain).
quotes.json?apikey=xxx&type=genre&search=age (Searching "age" genre).
quotes.json?apikey=xxx&pg=15&number=20 (Browsing with pagination).
An example response is as follows:
When have a full featured API for manufacturing images in a number of formats (including animated GIFs), and the quotes returned as above might be used with the API to return branded images. All clients will receive a zip file of branded quotes very early in our relationship. For others, a collection of around 25,000, 75,000, or 100,000 images is available for a small fee.
The background images are either user-supplied or a specific collection is chosen (the sample image below comes from the "nature" gallery). The most recent iteration of our API now returns a blurred background image by default (with crisp text it generally makes the quote pop out of the page).
The Image Factory API will be discussed another time.
Sample PHP Function
The following function is an example of one that might be used to retrieve search results.
Usage (close the pre tags):
A single result requires just the quote
- Searching by character count, word count etc. are all available, but their use is beyond the scope of this article.
- Every now and again we'll make a small collection of branded images available at no cost to our Facebook or mailing list following.
- A WordPress plugin is available to return paginated quote results in a WP website. We have another PHP script that is essentially a 'turnkey' quotes website. Both products work best with locally hosted images.
- Most of what's quoted on the Internet is what we wanted people to say, not what they actually said. Einstein and Marilyn Monroe are probably two of the hardest hit by distorted or fake attribution. However, short quotes are often a paraphrased sentiment, giving them a certain truth.