canonical: https://jentic.com/apis/quotable.io/quotable

# Quotable API

Quotable is a free, open source quotations API. It provides endpoints for fetching random quotes, listing quotes with pagination, searching quotes and authors, and browsing tags. The API exposes 9 endpoints.

## For AI agents

Programmatically get random quotes, get a single random quote (deprecated). Covers 9 operations.

## Scope

Does not handle payments, communications, or crm - use for identity and authentication only.

## Capabilities

- Get random quotes
- List quotes with pagination
- Search quotes (beta)
- Access Quotable API identity auth resources via REST API

## Use cases

### Identity and Authentication Operations

Use the Quotable API to perform identity auth operations programmatically. The API provides 9 endpoints covering core functionality including get random quotes, get a single random quote (deprecated), list quotes with pagination.

Example prompt: Call GET /quotes/random to get random quotes

### Automated Quotes Management

Automate quotes operations by combining multiple Quotable API endpoints. Agents can get a single random quote (deprecated) and then list quotes with pagination in a single workflow.

Example prompt: Call GET /random to get a single random quote (deprecated), then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Quotable API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle none tokens manually.

Example prompt: Search Jentic for 'get random quotes', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /quotes/random | Get random quotes |
| GET | /random | Get a single random quote (deprecated) |
| GET | /quotes | List quotes with pagination |
| GET | /quotes/{id} | Get a quote by ID |
| GET | /authors | List authors with pagination |
| GET | /search/quotes | Search quotes (beta) |
| GET | /search/authors | Search authors (beta) |
| GET | /tags | List all tags |

## Key resources

- **Quotes** — Endpoints for fetching and listing quotes
- **Authors** — Endpoints for listing and browsing authors
- **Search** — Full-text search endpoints for quotes and authors
- **Tags** — Endpoints for browsing quote tags

## Why Jentic

- **Setup:** Wiring the Quotable API by hand means targeting the api.quotable.io host and handling paging and retries across its quote, author, and tag reads yourself, even though it needs no auth. Through Jentic you install once, import Quotable from the API Directory, and your agent calls it without wiring the request paths.
- **Permission scoping:** Quotable puts the quote id in the URL path (/quotes/{id}), so a rule can pin your agent to one quote, and its other reads take filters in the request parameters. You choose which operations are allowed, so the agent reaches only the reads you list, such as random quotes or author search.
- **Credential handling:** Quotable needs no credential, so there is nothing to store: your own Jentic One instance still runs the call without exposing any secret to the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get a random quote' or 'search quotes by author', and Jentic returns the matching Quotable operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Auth0** — Alternative identity auth API
- **Okta** — Alternative identity auth API

## FAQ

### What authentication does the Quotable API use?

The Quotable API uses no authentication. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I get random quotes with the Quotable API?

Yes. Use the GET /quotes/random endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Quotable API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I get random quotes through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'get random quotes'. Jentic returns the matching Quotable API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Quotable API have?

The Quotable API exposes 9 endpoints covering quotes, authors, search operations.

### Can I limit what my agent is allowed to do with the Quotable API?

Yes. Because you run Jentic One yourself, your own rules decide which Quotable operations the agent may call, so you can allow only the reads you list, such as random quotes, quote listing, or author search, and leave the rest off. Since Quotable puts the quote id in the URL path (/quotes/{id}), a rule can pin the agent to a single quote, while its other reads accept filters in the request parameters that you constrain. The API needs no credentials, so there are no secrets to hand the agent, and it reaches only the endpoints you permit.