For Agents
Pull the quote of the day, search and favourite quotes, manage user sessions, and submit new quotes on the FavQs platform.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the FavQs API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with FavQs API API.
Pull the quote of the day from /qotd for daily content widgets
Search and list quotes with filter parameters via GET /quotes
Submit new user quotes via POST /quotes and edit them via PUT /quotes/{quote_id}
Favourite, upvote, downvote, or hide a quote with the dedicated action endpoints under /quotes/{quote_id}/...
GET STARTED
Use for: Get the quote of the day for today, Search for quotes by a specific author, Submit a new quote to the FavQs catalogue, Favourite a quote on behalf of a user
Not supported: Does not handle book metadata, author biographies, or licensed song lyrics — use for the FavQs quotes catalogue and account actions only.
The FavQs API exposes a curated quotes catalogue with browsing, searching, favoriting, voting, and account-management endpoints. The 29-endpoint surface covers a daily quote of the day at /qotd, full CRUD on user-submitted quotes, voting and favouriting actions, user accounts, sessions, and typeahead search. Authentication uses a two-token model: an app token for read access and a user token for actions taken on behalf of an account.
Manage user sessions for authenticated actions via /session
Provide typeahead suggestions for authors and tags via the typeahead endpoints
Patterns agents use FavQs API API for, with concrete tasks.
★ Daily Quote Widget for Apps and Sites
Productivity and lifestyle apps embed FavQs as their daily-quote source by polling GET /qotd each morning. The endpoint returns a structured quote object with author and tags suitable for direct rendering. Replaces hand-curated quote lists with a maintained catalogue.
Call GET /qotd once per day, cache the response, and render the quote, author, and tags in the app's home screen
Personalised Quote Feed
Apps that build a quote feed per user combine GET /quotes with theme filters and the favourite action endpoints to track which quotes a user liked. The favourites then drive a recommendation loop the next time the user opens the feed. Useful for journaling, meditation, and self-help products.
Search GET /quotes by tag, present results, and call PUT /quotes/{quote_id}/fav when the user taps favourite
Community Voting and Submission
Communities around quote sharing use POST /quotes for submissions and the upvote, downvote, fav, and hide endpoints under /quotes/{quote_id} for engagement. The session endpoints maintain authenticated identity. Lets a developer ship a community quote app without building moderation primitives from scratch.
POST /quotes with the user-supplied body and author, then call PUT /quotes/{quote_id}/upvote when other users upvote
AI Inspiration Bot via Jentic
Conversational bots that surface motivational content use Jentic to call FavQs from natural-language prompts. The agent searches 'get a quote of the day' and Jentic returns GET /qotd with its schema; the app token lives in the Jentic vault, so the agent never sees the raw key and ships in minutes.
Through Jentic, search 'get a daily inspirational quote', load GET /qotd, and post the response into the user's chat thread
29 endpoints — the favqs api exposes a curated quotes catalogue with browsing, searching, favoriting, voting, and account-management endpoints.
METHOD
PATH
DESCRIPTION
/qotd
Get the quote of the day
/quotes
Search and list quotes
/quotes
Submit a new quote
/quotes/{quote_id}/fav
Favourite a quote
/quotes/{quote_id}/upvote
Upvote a quote
/session
Create a user session
/users
Create a user account
/qotd
Get the quote of the day
/quotes
Search and list quotes
/quotes
Submit a new quote
/quotes/{quote_id}/fav
Favourite a quote
/quotes/{quote_id}/upvote
Upvote a quote
/session
Three things that make agents converge on Jentic-routed access.
Credential isolation
FavQs app and user tokens are stored encrypted in the Jentic vault. The agent calls operations by intent and Jentic injects the right header per endpoint — neither token enters prompt context.
Intent-based discovery
Agents search 'get a daily inspirational quote' and Jentic returns GET /qotd; for write actions, search 'favourite a quote' returns the right /quotes/{quote_id}/fav variant with its user-token requirement.
Time to first call
Direct integration: half a day to wire the two-token auth model and pagination. Through Jentic: under 30 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Quotable
Open-source quotes API without account features
Choose Quotable for simple unauthenticated reads; choose FavQs when users need favourites, voting, and submissions
API Ninjas
Multi-purpose data API including a quotes endpoint
Choose API Ninjas when you need many small data sources behind one key; choose FavQs for richer quote metadata and engagement endpoints
Pexels
Pair quote text with free imagery for shareable cards
Choose Pexels for the visual layer; FavQs supplies the quote body and attribution
Specific to using FavQs API API through Jentic.
What authentication does the FavQs API use?
FavQs uses two API keys: an app token in the Authorization header for read access and a user token in the User-Token header for actions taken on behalf of an account. Through Jentic both tokens live in the vault and are injected per operation.
Can I get a quote of the day with the FavQs API?
Yes. GET /qotd returns the curated quote of the day with author and tag metadata. The endpoint is read-only and only requires the app token, so no user session is needed to call it.
What are the rate limits for the FavQs API?
FavQs is rate limited to 30 requests per 20-second interval according to the published metadata. Cache /qotd responses for the day, batch quote searches where possible, and back off on 429 responses.
How do I favourite a quote through Jentic?
Install with pip install jentic, search 'favourite a quote on favqs', load PUT /quotes/{quote_id}/fav, and execute with the quote_id and the user-token credential drawn from your vault. Sign up at https://app.jentic.com/sign-up.
Can I submit user-generated quotes to FavQs?
Yes. POST /quotes accepts a new quote body and author with a user token, and PUT /quotes/{quote_id} edits an existing one. Use the action endpoints (fav, upvote, hide) to track engagement against submitted quotes.
Create a user session
/users
Create a user account