Install Jentic One Beta

Connect the FavQs API to your agent

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.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffavqs.com%2Ffavqs" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Ffavqs.com%2Ffavqs" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

What an agent can do with FavQs 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}/...

Manage user sessions for authenticated actions via /session

GET STARTED

Start building with FavQs API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use FavQs 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 your Jentic One instance, 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

Key Endpoints

29 endpoints — the favqs api exposes a curated quotes catalogue with browsing, searching, favoriting, voting, and account-management endpoints.

METHOD

PATH

DESCRIPTION

GET

/qotd

Get the quote of the day

GET

/quotes

Search and list quotes

POST

/quotes

Submit a new quote

PUT

/quotes/{quote_id}/fav

Favourite a quote

PUT

/quotes/{quote_id}/upvote

Upvote a quote

POST

/session

Create a user session

POST

/users

Create a user account

GET

/qotd

Get the quote of the day

GET

/quotes

Search and list quotes

POST

/quotes

Submit a new quote

PUT

/quotes/{quote_id}/fav

Favourite a quote

PUT

/quotes/{quote_id}/upvote

Upvote a quote

POST

/session

Create a user session

POST

/users

Create a user account

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the FavQs API by hand means formatting the app token as a Token header, exchanging credentials at /session for a User-Token, and attaching the right token per endpoint yourself. Through Jentic you install once, import FavQs from the API Directory, store the tokens once, and your agent calls it.

Permission scoping

FavQs puts the quote id in the URL path (/quotes/{quote_id}/fav and /quotes/{quote_id}/upvote), so a rule can pin your agent to one quote for those write actions. You choose the operations it may call, so favouriting or upvoting is included only when you add it, while the quote-of-the-day and listing reads stay read-only.

Credential isolation

Your FavQs app and user tokens are stored once, encrypted, by your own Jentic One instance and injected per endpoint at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'get a daily inspirational quote' or 'favourite a quote', and Jentic returns GET /qotd or the right /quotes/{quote_id}/fav variant with its user-token requirement so the agent calls the correct endpoint without browsing the docs.

FAQs

Specific to using FavQs 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. Get started with Jentic One, the self-hosted execution layer.

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.

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

Yes. Because you run Jentic One yourself, you decide which FavQs operations the agent may call, so you can allow the read-only quote-of-the-day (GET /qotd) and listing (GET /quotes) while withholding write actions. FavQs puts the quote id in the URL path for actions like PUT /quotes/{quote_id}/fav and PUT /quotes/{quote_id}/upvote, so your own rules can pin the agent to a single quote for those calls. Favouriting, upvoting, or submitting via POST /quotes is available only when you add it, and the app and user tokens are supplied by your instance rather than exposed to the agent.

FavQs API

Name: FavQs API
Brand: FavQs API
Availability: InStock

Official vendor OpenAPI document · agent-readyMediaContent DeliveryapiKey29 EndpointsREST

For Agents

Pull the quote of the day, search and favourite quotes, manage user sessions, and submit new quotes on the FavQs platform.

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.

Jentic One on Github View OpenAPI Document

Connect the FavQs API to your agent

Capabilities

Start building with FavQs API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

FavQs API