canonical: https://jentic.com/apis/agarathi.com/agarathi # Agarathi Dictionary API Jentic publishes the only available OpenAPI specification for Agarathi Dictionary API, keeping it validated and agent-ready. Agarathi is a Tamil dictionary service that exposes a small but focused API: list the available Tamil dictionaries, fetch the word of the day, and search for Tamil word definitions across multiple lexical sources. Useful for language-learning apps, content moderation pipelines that need Tamil semantic context, and AI agents handling Tamil-language inputs. ## For AI agents Look up Tamil word definitions, browse the supported Tamil dictionaries, and fetch the word of the day for language and content workflows. ## Scope Does not handle translation, transliteration, or grammar parsing - use for Tamil dictionary definition lookups only. ## Capabilities - Look up Tamil word definitions across multiple supported dictionaries - List the dictionaries available so an app can offer source selection - Fetch the daily word-of-the-day entry for editorial widgets - Search by Tamil word to retrieve associated meanings and parts of speech - Drive Tamil vocabulary features inside language-learning apps ## Use cases ### Tamil Language-Learning App Tamil language-learning apps use Agarathi to expose dictionary lookups inside their lesson and reading flow. Learners tap a Tamil word and the app calls /dictionary/search to display all known meanings across Agarathi's supported dictionaries. /dictionary/list lets the app surface a source-picker so advanced learners can pick a specific lexicon. Example prompt: Call GET /dictionary/search with the Tamil word for 'rain' and return all returned definitions grouped by dictionary source ### Editorial Word-of-the-Day Widget News and culture sites that publish Tamil content can drop a word-of-the-day widget on a homepage by calling GET /dictionary/wod once per day. The endpoint returns the headword and a definition that the site renders inside its template, refreshed via a daily cache. Example prompt: Call GET /dictionary/wod each morning and cache the result for the homepage word-of-the-day block ### Tamil Content Moderation Lookup Content moderation pipelines that flag Tamil text can use Agarathi to confirm the meaning and register of a flagged term before deciding to action it. /dictionary/search returns dictionary entries that human reviewers see alongside the flagged text, reducing false positives on terms that are dialectal or archaic. Example prompt: For each Tamil token flagged by an upstream classifier, call GET /dictionary/search and surface the top definition for a human reviewer ### AI Agent Tamil Reasoning Agents handling Tamil-language inputs can use Agarathi via Jentic to ground their answers in dictionary definitions instead of relying solely on LLM training data. The agent searches Jentic for the lookup, executes /dictionary/search, and uses the returned entries to disambiguate meaning before responding. Example prompt: Search Jentic for 'tamil word definition', load the GET /dictionary/search schema, and execute with a user-supplied Tamil headword ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | /dictionary/list | List supported Tamil dictionaries | | GET | /dictionary/wod | Fetch the word of the day | | GET | /dictionary/search | Search Tamil word definitions | ## Key resources - **Dictionary** — List, search, and word-of-the-day operations across Tamil dictionaries ## Why Jentic - **Setup:** Wiring the Agarathi Dictionary API by hand means managing its secret-key request header and coding calls across its dictionary lookup endpoints. Through Jentic you install once, import the Agarathi Dictionary API from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Agarathi exposes a small read-only surface where lookups take their input as query parameters, so limit the agent to the operations it needs, such as searching for a word. You choose which read operations are in the allowed set, so anything you leave out is not reachable. - **Credential handling:** Your Agarathi API key is stored once, encrypted, by your own Jentic One instance and injected as the secret-key header at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'Tamil word lookup', and Jentic returns the matching Agarathi operation with its parameter schema so the agent calls the search endpoint without browsing the reference docs. ## Related APIs - **Wordnik API** — English dictionary API with definitions, examples, and word-of-the-day. - **Merriam-Webster API** — English dictionary and thesaurus API from a major lexical publisher. - **Afosto API** — Search platform that can index Agarathi entries for in-app full-text search. ## FAQ ### Why is there no official OpenAPI spec for Agarathi Dictionary API? Agarathi does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Agarathi Dictionary 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 Agarathi Dictionary API use? Agarathi requires an API key sent in the X-Agarathi-Api-Secret header. Through Jentic, this header value is populated at execution time from the encrypted credential vault. ### Can I look up a Tamil word's meaning with this API? Yes. GET /dictionary/search accepts a Tamil headword and returns matching dictionary entries. GET /dictionary/list shows the available dictionaries you can target. ### What are the rate limits for the Agarathi Dictionary API? The public spec does not document rate limits. For language-learning apps with bursty per-user lookups, cache definitions client-side so a single popular word is not fetched repeatedly. Back off on HTTP 429. ### How do I integrate Agarathi lookups through Jentic? Search Jentic for 'tamil dictionary lookup', load the GET /dictionary/search schema, and execute with the headword. Jentic returns the dictionary entries directly to your agent so you can render or reason over them. ### Is the Agarathi Dictionary API free? Agarathi historically offers a free developer tier with API-key gated access. Higher-volume tiers and commercial use should be confirmed with the Agarathi team via the docs site. ### Can I limit what my agent is allowed to do with the Agarathi Dictionary API? Yes. Because you run Jentic One yourself, your own rules decide which of the Agarathi operations your agent can call, and the Agarathi surface is read-only, so nothing your agent does can modify data. You can allow only GET /dictionary/search so the agent can look up a Tamil word while leaving GET /dictionary/list and GET /dictionary/wod out of the allowed set, and any operation you do not include stays unreachable. Your API key is injected into the request header at execution time by your own instance, so the agent never sees the credential.