Skip to content

They Said So Quotes API API

by quotes.rest

API keyHTTPSOpen Data
Open documentation ↗

Overview

They Said So Quotes API offers a complete feature rich REST API access to its quotes platform. This is the documentation for the world famous [quotes API](https://theysaidso.com/api). If you are a subscriber and you are trying this from a console add 'X-TheySaidSo-Api-Secret' header and add your api key as the header value. You can test and play with the API right here on this web page. For using the private end points and subscribing to the API please visit https://theysaidso.com/api.

They Said So Quotes API is an open data API from quotes.rest. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 47 endpoints.

At a glance

Authentication
API key
HTTPS
Yes
CORS
Unknown
Category
Open Data
Base URL
https://quotes.rest
Version
3.1
Endpoints
47
Spec updated
2021-06-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://quotes.rest/qod" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://quotes.rest/qod", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://quotes.rest/qod",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/qodGets `Quote of the Day`. Optional `category` param determines the category of returned quote of the day
GET/qod/categoriesGets a list of `Quote of the Day` Categories.
GET/qod/languagesGets a list of supported languages for `Quote of the Day`.
GET/qshowGets a details about a qshow.
PUT/qshowCreate and add a new qshow to your private collection.
PATCH/qshowUpdate an existing qshow.
DELETE/qshowDelete a qshow.
GET/qshow/listGet the list of Qshows in They Said So platform.
GET/qshow/quotesGet the quotes in a given Qshow.
POST/qshow/quotes/addAdd a quote to a given Qshow.
POST/qshow/quotes/removeRemove a quote to a given Qshow.
GET/quoteGets a `Quote` with a given `id`.
POST/quoteAdd a new quote to your private collection. Same as 'PUT' but added since some clients don't handle PUT well.
PUT/quoteAdd a new quote to your private collection.
PATCH/quoteUpdate a quote
DELETE/quoteDelete a quote. The user needs to be the owner of the quote to be able to delete it.
GET/quote/authors/popularGets a list of popular author names in the system.
GET/quote/authors/searchGets a list of author names in the system.
GET/quote/categories/popularGets a list of popular `Quote` Categories.
GET/quote/categories/searchGets a list of `Quote` Categories matching the query string.
POST/quote/dislikeDislike the given Quote as a user of the API Key. Same as `put` but a convenient alias for those clients that don't support `put` cleanly.
PUT/quote/dislikeDislike the given Quote as a user of the API Key. Some clients don't cleanly support `PUT`, in such scenarios use the `POST` version of this.
DELETE/quote/dislikeRemove the disLike for the given Quote as a user of the API Key.
GET/quote/imageGets a Quote image for a given id. Response can be an image file as a binary or a base64 encoded contents wrapped in json. `TODO`
PUT/quote/imageCreate a new quote image for a given quote. Choose background colors/images , choose different font styles and generate a beautiful quote image. Did you just ha
DELETE/quote/imageDelete a quote image. The user needs to be the owner of the quote image to be able to delete it.
POST/quote/image/backgroundAdd an image for use later as a quote background image.
DELETE/quote/image/backgroundDelete a background image file. The user needs to be the owner of the background image to be able to delete it.
GET/quote/image/background/listLists background images in your private collection.
GET/quote/image/background/searchSearches for a background image with a given tag.
POST/quote/image/background/tags/addAdd a tag to a given Image.
POST/quote/image/background/tags/removeRemove a tag from a given Image.
POST/quote/image/fontAdd a font file for use later in creating a quote image. This is essentially a `PUT` but not many clients handle PUT with binary stream i.e. a file, gracefully.
DELETE/quote/image/fontDelete a font file. The user needs to be the owner of the font to be able to delete it.
GET/quote/image/font/listLists background images in your private collection.
GET/quote/image/font/searchSearches for a font with a given tag.
POST/quote/image/font/tags/addAdd a tag to a given font.
POST/quote/image/font/tags/removeRemove a tag from a given Font.
GET/quote/image/searchGets a Random Quote image. Optional `category` param determines the category of quote used in the image. Optional `author` param gets the quote image of a given
POST/quote/likeLike the given Quote as a user of the API Key. Same as `PUT` but a convenient alias for those clients that don't support `PUT` cleanly.
PUT/quote/likeLike the given Quote as a user of the API Key. Some clients don't cleanly support `PUT`, in such scenarios use the `POST` version of this.
DELETE/quote/likeRemove the Like for the given Quote as a user of the API Key.
GET/quote/listGet the list of quotes in your private collection.
GET/quote/randomGets a `Random Quote`. When you are in a hurry this is what you call to get a random famous quote.
GET/quote/searchSearch for a `Quote` in They Said So platform. Optional `category` , `author`, `minlength`, `maxlength` params determines the filters applied while searching fo
POST/quote/tags/addAdd a tag to a given Quote.
POST/quote/tags/removeRemove a tag from a given quote.

Questions

Does the They Said So Quotes API API need an API key?

Yes. The They Said So Quotes API API uses API key authentication; the documentation explains how to get credentials.

Does the They Said So Quotes API API support HTTPS?

Yes, the They Said So Quotes API API is served over HTTPS.

How many endpoints does the They Said So Quotes API API have?

Its OpenAPI description lists 47 endpoints in version 3.1. All of them are shown on this page.

What are alternatives to the They Said So Quotes API API?

Other Open Data APIs include Search Services, Wayback API, Wikipedia, Nasdaq Data Link, University of Oslo.

Compare alternatives →

Listed from APIs.guru (CC0).