# They Said So - Service Overview

> They Said So is world's top inspirational quotes platform with over a million famous quotes from history's greatest thinkers, authors, leaders, and visionaries. The service provides both a browsable web experience and a REST API enabling developers to integrate quotes, authors, and daily inspiration into their own apps. They Said So have been serving the world for more than 15+ years.

## What They Said So does
- Serves over a million famous quotes across 500+ categories including wisdom, humor, love, success, philosophy, and more
- Provides a Quote of the Day (QOD) with curated daily quotes per category and language
- Organises quotes by author — browse or search quotes from thousands of named authors
- Organises quotes by topic/tag — explore quotes on any subject from friendship to leadership
- Generates shareable quote images combining quote text with curated backgrounds and fonts
- Offers curated QShows — themed collections of quotes built by the community
- Provides a Bible verse API for random verses, verse-of-the-day, and scripture search
- Provides a REST API for all quote data with JSON, XML, and JSONP format support

## Sage - AI Wisdom Companion

Sage is an AI-powered wisdom companion from They Said So that lets users explore ideas, perspectives, and philosophies through conversations inspired by history's greatest minds. Users can ask questions, seek different perspectives, and have conversations with AI representations of influential thinkers, leaders, authors, artists, entrepreneurs, and other notable figures.

- Explore conversations with historical and influential figures including philosophers, leaders, writers, artists, scientists, and entrepreneurs
- Ask questions about leadership, creativity, relationships, business, philosophy, decision-making, resilience, and other topics
- Explore how different historical figures might approach the same question or problem
- Responses are informed by documented quotes, writings, ideas, biographies, and historical context associated with each figure
- Sage distinguishes AI-generated perspectives from verified historical quotations rather than presenting generated responses as literal quotes
- Provides an interactive way to explore the ideas and philosophies represented throughout the They Said So knowledge base
- [Sage](https://theysaidso.com/sage): Explore history's greatest minds through AI-powered conversations

## API
- [API Overview](https://theysaidso.com/api): Full REST API for quotes, authors, categories, and daily inspiration
- [Inspiration API](https://theysaidso.com/api/inspiration): Daily inspiration feed by type
- Free tier: limited access for testing purposes
- Paid plans available for higher volume usage
- Authentication: pass API key as `?api_key=YOUR_KEY` or as `Authorization: Bearer <key>` header

## Quotes API

- [Random Quote](https://theysaidso.com/api/quote/random): Fetch a random quote, optionally filtered by category or author
- [Quote of the Day](https://theysaidso.com/api/qod): Today's curated quote; supports 500+ category filters and multiple languages
- [QOD Categories](https://theysaidso.com/api/qod/categories): List all available Quote of the Day categories
- [QOD Languages](https://theysaidso.com/api/qod/languages): List all supported QOD languages
- [Quote Search](https://theysaidso.com/api/quote/search): Full-text search across the quotes database
- [Quote List](https://theysaidso.com/api/quote/list): Paginated listing of quotes with optional filters
- [Single Quote](https://theysaidso.com/api/quote): Retrieve a specific quote by ID
- [Liked Quotes](https://theysaidso.com/api/quote/list/liked): List quotes liked by the authenticated user
- [Bookmarked Quotes](https://theysaidso.com/api/quote/list/bookmarked): List quotes bookmarked by the authenticated user

## Authors API

- [Popular Authors](https://theysaidso.com/api/quote/authors/popular): Most popular quoted authors on the platform
- [Author Search](https://theysaidso.com/api/quote/authors/search): Search authors by name
- [Author Quotes Page](https://theysaidso.com/quotes/author/{slug}): Browse all quotes by a specific author

## Categories & Topics API

- [Popular Categories](https://theysaidso.com/api/quote/categories/popular): Most popular quote categories/tags
- [Category Search](https://theysaidso.com/api/quote/categories/search): Search available quote categories
- [Quotes by Topic](https://theysaidso.com/quotes/on/{tag}): Browse all quotes on a specific topic

## Quote Images API

- [Random Quote Image](https://theysaidso.com/api/quote/image/random): Random quote rendered as a shareable image
- [Popular Quote Images](https://theysaidso.com/api/quote/image/popular): Most popular quote images
- [Quote Image Search](https://theysaidso.com/api/quote/image/search): Search quote images
- [Background List](https://theysaidso.com/api/quote/image/background/list): List available image backgrounds
- [Background Search](https://theysaidso.com/api/quote/image/background/search): Search image backgrounds
- [Font List](https://theysaidso.com/api/quote/image/font/list): List available fonts for quote images
- [Font Search](https://theysaidso.com/api/quote/image/font/search): Search available fonts

## QShow (Curated Collections) API

- [QShow List](https://theysaidso.com/api/qshow/list): List all curated quote collections
- [QShow Detail](https://theysaidso.com/api/qshow): Retrieve a specific QShow by ID
- [QShow with Quotes](https://theysaidso.com/api/qshow/quotes): Retrieve a QShow together with its full quote listing
- [Browse QShows](https://theysaidso.com/q-show): Explore community-curated quote collections on the web

## Bible API

- [Random Bible Verse](https://theysaidso.com/api/bible/random): Random Bible verse
- [Verse of the Day](https://theysaidso.com/api/bible/vod): Today's featured Bible verse
- [Bible Verse Search](https://theysaidso.com/api/bible/search): Search Bible verses by keyword

## Inspiration API

- [Daily Inspiration](https://theysaidso.com/api/inspiration/{type}): Retrieve daily inspiration by type (e.g. quote, verse)

## Web Pages

- [Home](https://theysaidso.com/): Curated daily quotes and featured inspiration
- [Quote of the Day](https://theysaidso.com/quote-of-the-day): Today's featured quote with category options
- [Random Quote](https://theysaidso.com/random): Load a random quote instantly
- [All Authors](https://theysaidso.com/quotes/author): Browse the full author directory
- [All Topics](https://theysaidso.com/quotes/on): Browse all quote topics and categories
- [Search Quotes](https://theysaidso.com/search/quotes): Full-text quote search
- [Search Authors](https://theysaidso.com/search/authors): Author search
- [Curated Images](https://theysaidso.com/curated): Browseable gallery of curated quote images
- [QOD Feeds](https://theysaidso.com/qod/feed): Atom/RSS feeds for Quote of the Day by category

## API Plans

| Plan | Daily Calls | Features |
|------|-------------|---------|
| Free | Limited | Selected endpoints, testing only |
| Premium ($9.99/mo) | 2,000 | JSON / XML / JSONP, standard support |
| Ultra ($24.99/mo) | 6,000 | Bulk retrieval, custom QOD, priority support |
| Enterprise ($74.99/mo) | 24,000 | Bulk retrieval, custom QOD, quote images, premium support |

## Key Facts
- Over a million famous quotes in the database; collection grows continuously
- 500+ categories covering wisdom, love, humor, success, philosophy, leadership, and more
- Supports JSON, XML, and JSONP response formats
- CORS enabled — make cross-origin requests directly from the browser
- Quote of the Day available in multiple languages with per-category feeds
- Quote images combinable with custom backgrounds and fonts via API
- Atom/RSS feeds available for QOD categories

## Legal & Policy
- [Terms of Service](https://theysaidso.com/terms): User obligations and usage terms for the quotes platform and API.
- [Privacy Policy](https://theysaidso.com/privacy): Data handling practices for user accounts and API usage.

## Contact
- Twitter / X: https://twitter.com/theysaidso
- API sign-up: https://theysaidso.com/api