canonical: https://jentic.com/apis/adviceslip.com/adviceslip # Advice Slip API Jentic publishes the only available OpenAPI specification for Advice Slip API, keeping it validated and agent-ready. The Advice Slip API returns short pieces of advice as JSON, intended as a free, no-auth content source for demos, tutorials, and prototype apps. Three endpoints cover a random advice slip, lookup of a slip by numeric id, and a substring search across the advice corpus. Because no API key is required, it is one of the simplest endpoints to wire into an agent or a beginner tutorial. ## For AI agents Fetch a random or specific piece of advice, or search advice by keyword, from a free unauthenticated JSON API. ## Scope Does not handle authoring, user submissions, ratings, or attribution - use for read-only random-advice lookups only. ## Capabilities - Pull a random advice slip via GET /advice for placeholder content in demos and onboarding flows - Retrieve a specific advice slip by its numeric id via GET `/advice/{slip_id}` for stable, citable quotes - Search the advice corpus by substring via GET `/advice/search/{query}` to surface matching slips - Use as an unauthenticated test target when prototyping agent tool calls or building API client samples - Embed lightweight inspirational content into chatbots, dashboards, or status pages with a single call ## Use cases ### Random Content for Demos and Tutorials When teaching API integration, building a prototype, or filling a UI with placeholder text, the Advice Slip random endpoint returns a short JSON payload with no authentication. Tutorials use it to demonstrate fetch and parse loops, and prototype dashboards use it to fill empty states. The whole integration is a single GET /advice call returning a small slip object. Example prompt: Call GET /advice and return the returned slip's advice field as a string ### Searchable Advice Corpus Build features that surface relevant advice based on a user keyword. The `/advice/search/{query}` endpoint accepts a substring and returns all matching slips. This is useful for chat experiences where a user types a topic ('focus', 'money') and the agent returns related slips, or for content tools that pull a quote matching an article's theme. Example prompt: Call GET `/advice/search/money` and return the first three slips whose advice text contains the word 'money' ### Stable Daily Quote by ID Use a numeric slip id when the application needs a deterministic piece of content - a daily inspiration card, a saved favourite, or a citation. `/advice/{slip_id}` returns the same slip every call for a given id, so a 'quote of the day' rotation can pin specific ids per date without storing the text locally. Example prompt: Call GET `/advice/117` and return that slip's advice text for a 'quote of the day' display ### Agent Smoke Test via Jentic When validating a new Jentic agent setup or MCP wiring, the Advice Slip API is the lowest-friction call available - no key, no rate-limit setup, no payload to construct. An agent can search Jentic for 'random advice', load the operation, and execute it as a smoke test that confirms the search-load-execute path works before wiring up a credentialed API. Example prompt: Use Jentic to search 'get random advice', load the GET /advice operation, and execute it to confirm the agent's tool-call path returns a valid slip ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/advice` | Return a random advice slip | | GET | `/advice/{slip_id}` | Return the advice slip with the given id | | GET | `/advice/search/{query}` | Search advice slips by substring | ## Key resources - **Advice slip** — A single piece of advice with a numeric id and text - **Advice search** — Substring match over the advice corpus ## Why Jentic - **Setup:** The Advice Slip API is unauthenticated, so wiring it by hand still leaves you writing your own request, retry, and rate-limit handling. Through Jentic you install once, import Advice Slip from the API Directory, and your agent calls it through the same execution layer as your other tools. - **Permission scoping:** Advice Slip takes its slip id and search query in the URL path for read-only lookups, so you limit the agent to the operations it needs, such as getting random advice or searching by keyword. Every operation on this surface is read-only, so the agent reads advice without changing anything. - **Credential handling:** Advice Slip is unauthenticated, so there is no credential to store. Jentic still routes the request through its execution layer so logging, tracing, and rate-limit handling stay consistent with the agent's other calls. - **Discovery method:** Agents search Jentic by intent such as 'get random advice' or 'search advice by keyword', and Jentic returns the matching Advice Slip operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Quotable** — Free quotes API - broader corpus and tag-based search compared to Advice Slip's plain advice list - **Stripe** — Pair lightweight content with billing when prototyping a paid quote-of-the-day product - **ADS-B Exchange API** — Another Jentic-generated single-endpoint API often used in agent tutorials ## FAQ ### Why is there no official OpenAPI spec for Advice Slip API? Advice Slip does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Advice Slip API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Advice Slip API use? None. The Advice Slip API is fully unauthenticated - there are no securitySchemes in the spec and no header or query credential is required. When called through Jentic the request is dispatched without a vault credential. ### Can I search advice slips by keyword with the Advice Slip API? Yes. GET `/advice/search/{query}` performs a substring match against the advice corpus and returns every slip whose text contains the query. The response includes the total match count and the matching slip objects. ### How do I get a random piece of advice through Jentic? Search Jentic for 'get random advice', load the GET /advice operation, and execute it. Because the API has no auth, the call returns a slip immediately and is a useful smoke test for new Jentic agent integrations. ### Is the Advice Slip API free? Yes. Advice Slip is a free public API with no authentication, no paid tier, and no published rate limit. Treat it as best-effort - do not build production-critical features on top of it without caching. ### Can I retrieve a specific advice slip by id? Yes. GET `/advice/{slip_id}` accepts a numeric id and returns the same slip on every call, which makes it suitable for stable references such as daily-quote rotations or saved favourites. ### Can I limit what my agent is allowed to do with the Advice Slip API? Yes. Because Jentic One is self-hosted, your own rules decide which Advice Slip operations the agent may call, so you can allow just getting random advice, looking up a slip by id, or searching by keyword and block the rest. Every operation on this API is read-only and takes its slip id or search query in the URL path, so the agent reads advice without changing any data. The API needs no credentials, so you scope access purely by the operations you expose to the agent.