usito.usherbrooke.ca APIusito.usherbrooke.ca ↗
Access the USITO Québec French dictionary via API. Retrieve word definitions, phonetics, grammatical classes, and full verb conjugation tables across 6 endpoints.
curl -X GET 'https://api.parse.bot/scraper/139b98c8-2ae5-4209-8cc5-3f398e60385e/get_word_index_by_letter?letter=z' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches the list of all words/expressions for a given letter from the dictionary index. Returns all words starting with the specified letter, with pagination handled internally.
| Param | Type | Description |
|---|---|---|
| letterrequired | string | Single lowercase letter (a-z) to browse the dictionary index. |
{
"type": "object",
"fields": {
"data": "array of word index entries with id, slug, word, gender, lexie_id, grammatical_class",
"status": "string, always 'success'"
},
"sample": {
"data": [
{
"id": "d06c3Bd8d51111e1-DD8CaDBE53d2e136-f5fb09760Fd2e133-z",
"slug": "z_1",
"word": "z",
"gender": "m",
"lexie_id": "",
"grammatical_class": "nom"
}
],
"status": "success"
}
}About the usito.usherbrooke.ca API
The USITO API exposes 6 endpoints covering the full USITO Québec French dictionary published by Université de Sherbrooke, including word definitions, phonetic transcriptions, grammatical classifications, and complete verb conjugation tables. The get_word_entry endpoint returns a structured object with phonetic, definition, and grammatical_class fields for any word slug, while get_verb_conjugation delivers a full HTML conjugation table for any verb.
Word Lookup and Search
The search_words endpoint accepts a query string and returns an array of matching entries, each with a slug, type, word, and grammatical_class. Those slugs feed directly into get_word_entry, which returns the full dictionary article for a single word: id, url, word, phonetic (IPA transcription), definition, and grammatical_class. Slugs follow USITO conventions — disambiguated entries use suffixes like chat_1 or être_1 when multiple lexical entries share the same spelling.
Browsing by Letter
get_word_index_by_letter accepts a single lowercase letter parameter and returns every indexed word starting with that letter, with each entry carrying id, slug, word, gender, lexie_id, and grammatical_class. For bulk workflows, get_all_words_for_letter combines the index lookup with definition retrieval in one call and accepts an optional limit integer to cap how many full entries are fetched — useful when you only need the first N words of a given letter rather than the entire set.
Verb Conjugation
get_conjugation_models returns the full list of conjugation model names, slugs, and verb_count figures used by USITO. Each model slug can be passed to get_verb_conjugation, which returns an object containing slug and html_table — the complete conjugation table for that verb. The endpoint automatically retries with a _1 suffix when the base slug does not resolve to a conjugation table, handling USITO's disambiguation pattern transparently.
Coverage Scope
All six endpoints draw from the USITO dictionary, which specifically documents Québec French vocabulary and usage. The dictionary includes words with gender annotations, multiple grammatical classes, and a conjugation model system tied to standard French verb paradigms. Index entries expose lexie_id fields that map to individual lexical senses within a headword.
- Build a Québec French vocabulary app that displays IPA phonetics and definitions from
get_word_entry - Generate a full offline word list by iterating
get_word_index_by_letteracross a–z - Render verb conjugation tables in a language-learning tool using
get_verb_conjugationHTML output - Implement an autocomplete feature backed by
search_wordsreturning slugs and grammatical classes - Audit vocabulary coverage by pulling
verb_countper model fromget_conjugation_models - Build a grammar reference tool that filters words by
grammatical_classacross a given letter's index - Populate a French-Canadian dictionary dataset with phonetic and definition fields via
get_all_words_for_letter
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does USITO (usherbrooke.ca) offer an official developer API?+
What does `get_word_entry` return, and how do I get the right slug?+
get_word_entry returns an object with id, url, word, phonetic (IPA), definition, and grammatical_class for the requested slug. Slugs follow USITO naming: plain form for unambiguous words (e.g. abaca) and a _1, _2 suffix pattern for disambiguated headwords (e.g. chat_1). Use search_words or get_word_index_by_letter first to obtain the correct slug before calling get_word_entry.Does the API expose example sentences or usage notes from dictionary articles?+
get_word_entry response covers definition, phonetic, and grammatical_class but does not separately surface example sentences or usage labels that may appear in the full article. You can fork this API on Parse and revise it to extract those additional fields from the article data.Is the conjugation table returned as structured data or raw HTML?+
get_verb_conjugation returns the conjugation table as html_table — a raw HTML string — rather than a parsed tense-by-tense data structure. The slug field in the response confirms which verb was resolved. If your application needs tense and person as discrete fields, you can fork this API on Parse and revise it to parse the HTML table into structured rows.Does `get_word_index_by_letter` cover all letters in the French alphabet, including accented letters?+
letter parameter accepts a single lowercase Latin letter in the range a–z. Accented headwords (é, è, ê, etc.) are indexed under their base letter — so words beginning with é appear under e. There is no separate parameter for accented variants. You can fork this API on Parse and revise it to add accent-specific filtering if needed.