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
- OpenAPI
- Specification ↗
- Spec updated
- 2021-06-21
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://quotes.rest/qod" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"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);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
| Method | Path | What it does |
|---|---|---|
| GET | /qod | Gets `Quote of the Day`. Optional `category` param determines the category of returned quote of the day |
| GET | /qod/categories | Gets a list of `Quote of the Day` Categories. |
| GET | /qod/languages | Gets a list of supported languages for `Quote of the Day`. |
| GET | /qshow | Gets a details about a qshow. |
| PUT | /qshow | Create and add a new qshow to your private collection. |
| PATCH | /qshow | Update an existing qshow. |
| DELETE | /qshow | Delete a qshow. |
| GET | /qshow/list | Get the list of Qshows in They Said So platform. |
| GET | /qshow/quotes | Get the quotes in a given Qshow. |
| POST | /qshow/quotes/add | Add a quote to a given Qshow. |
| POST | /qshow/quotes/remove | Remove a quote to a given Qshow. |
| GET | /quote | Gets a `Quote` with a given `id`. |
| POST | /quote | Add a new quote to your private collection. Same as 'PUT' but added since some clients don't handle PUT well. |
| PUT | /quote | Add a new quote to your private collection. |
| PATCH | /quote | Update a quote |
| DELETE | /quote | Delete a quote. The user needs to be the owner of the quote to be able to delete it. |
| GET | /quote/authors/popular | Gets a list of popular author names in the system. |
| GET | /quote/authors/search | Gets a list of author names in the system. |
| GET | /quote/categories/popular | Gets a list of popular `Quote` Categories. |
| GET | /quote/categories/search | Gets a list of `Quote` Categories matching the query string. |
| POST | /quote/dislike | Dislike 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/dislike | Dislike 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/dislike | Remove the disLike for the given Quote as a user of the API Key. |
| GET | /quote/image | Gets 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/image | Create 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/image | Delete a quote image. The user needs to be the owner of the quote image to be able to delete it. |
| POST | /quote/image/background | Add an image for use later as a quote background image. |
| DELETE | /quote/image/background | Delete 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/list | Lists background images in your private collection. |
| GET | /quote/image/background/search | Searches for a background image with a given tag. |
| POST | /quote/image/background/tags/add | Add a tag to a given Image. |
| POST | /quote/image/background/tags/remove | Remove a tag from a given Image. |
| POST | /quote/image/font | Add 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/font | Delete a font file. The user needs to be the owner of the font to be able to delete it. |
| GET | /quote/image/font/list | Lists background images in your private collection. |
| GET | /quote/image/font/search | Searches for a font with a given tag. |
| POST | /quote/image/font/tags/add | Add a tag to a given font. |
| POST | /quote/image/font/tags/remove | Remove a tag from a given Font. |
| GET | /quote/image/search | Gets 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/like | Like 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/like | Like 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/like | Remove the Like for the given Quote as a user of the API Key. |
| GET | /quote/list | Get the list of quotes in your private collection. |
| GET | /quote/random | Gets a `Random Quote`. When you are in a hurry this is what you call to get a random famous quote. |
| GET | /quote/search | Search for a `Quote` in They Said So platform. Optional `category` , `author`, `minlength`, `maxlength` params determines the filters applied while searching fo |
| POST | /quote/tags/add | Add a tag to a given Quote. |
| POST | /quote/tags/remove | Remove 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.
Similar open data APIs
Compare alternatives →Search Services
Open DataAPI for Internet Archive's Search-related services
Wayback API
Open DataAPI for Internet Archive's Wayback Machine
Wikipedia
Open DataMediawiki Encyclopedia
Nasdaq Data Link
Open DataThe source for financial, economic, and alternative datasets, serving investment professionals.
University of Oslo
Open DataCourses, lecture videos, detailed information for courses etc. for the University of Oslo (Norway)
Data API
Open DataServes the Clever Data API
Listed from APIs.guru (CC0).