Docs / Quotes Data API
Quotes Data API
Attributed quotations with author, category and the collection each was gathered from. Only the active pool is served -- the upstream's own judgement about what is fit to show -- and the quote-of-the-day endpoint is deterministic for a given UTC date, so one call a day is enough.
Live
https://api.softon.dev/v1
v1 · stable
Endpoints
| Endpoint | Route | Returns |
|---|---|---|
| List quotations | GET /v1/quotes |
collection |
| Retrieve a quotation | GET /v1/quotes/{id} |
single object |
| Quote of the day | GET /v1/quotes/random |
single object |
The Quote object
The fields below appear on the dataset's primary resource. Endpoint pages list any fields specific to them.
| Field | Type | Description |
|---|---|---|
id |
string | Stable identifier, "<source>:<source id>". |
source |
string | Which scraper delivered this quotation. |
text |
string | The quotation. |
author |
string · nullable | Attributed author. null where the collection does not name one. |
category |
string · nullable | The upstream's own label. A folksonomy, not an enum -- tens of thousands of distinct values -- so treat it as a tag rather than a fixed set. |
origin |
string · nullable | Where the quotation was collected from, e.g. "passiton". Distinct from source, which is the scraper that delivered it. |
ingested_at |
timestamp | When this version was stored. |