# Quotia

> A developer-friendly words API: quotes as clean, paginated JSON, and generated
> crossword puzzles. Both filterable by category, neither needing an API key.

Quotia requires no authentication or API key. Quotes are
collected live from public quote sites and cached in memory for 5 minutes. Because
results are collected per request, `total` reflects what was retrieved for that
request rather than a fixed catalogue size. Each quote carries a `source` field
for attribution.

## API

- [GET /v1/quote](https://quotia.vercel.app/v1/quote): Returns a page of quotes. Query
  parameters: `category` (tag such as love, inspirational, humor), `page`
  (1-based, default 1), `page_size` (1-100, default 10), `seed`
  (shuffle the result set deterministically). Responds with
  `quotes`, `category`, `page`, `page_size`, `total`, `total_pages`, `has_next`,
  `has_previous`. Each quote has `text`, `author`, `source`, `tags`, `id`.

- [GET /v1/quote/daily](https://quotia.vercel.app/v1/quote/daily): The day's selection, the
  same for every caller until UTC midnight. Query parameters: `category`,
  `page_size`. Adds `date` and `seed` to the response above.

- [GET /v1/crossword](https://quotia.vercel.app/v1/crossword): Generates a playable crossword.
  Query parameters: `category` (animals, food, geography, music, science, sports),
  `size` (7-21, default 11), `word_count`, and `seed`.
  Responds with `puzzle` (grid to solve), `solution`, and numbered `across`/`down`
  clues carrying `row`, `col` and `length`. `"#"` marks a blank cell. Generated in
  memory with no upstream request, and deterministic for a given `seed`.
- [GET /v1/crossword/categories](https://quotia.vercel.app/v1/crossword/categories): Valid crossword categories.

## MCP

- [MCP server](https://quotia.vercel.app/mcp): Streamable HTTP endpoint exposing `search_quotes`,
  `random_quote`, `list_categories`, `generate_crossword` and
  `list_crossword_categories` as typed tools. No authentication required.

## Docs

- [Quickstart](https://quotia.vercel.app/quickstart): First request, every parameter, and the response shape.
- [Pricing](https://quotia.vercel.app/pricing): Plans and limits.
- [Privacy](https://quotia.vercel.app/privacy) and [Terms](https://quotia.vercel.app/terms): How data is handled and the terms of use.
- [OpenAPI schema](https://quotia.vercel.app/openapi.json): Machine-readable specification of the API.
- [ReDoc reference](https://quotia.vercel.app/redoc): Reference-style documentation.
- [Swagger UI](https://quotia.vercel.app/docs): Interactive documentation you can send requests from.
- [Full details](https://quotia.vercel.app/llms-full.txt): Parameters, response schema and examples in one file.

## Attribution

- [quotes.toscrape.com](http://quotes.toscrape.com): Reported as `source: "toscrape"`.
- [goodreads.com/quotes](https://www.goodreads.com/quotes): Reported as `source: "goodreads"`.