See below how to specify which resource to look in, when querying the API for a specific language.

GET /search

Search for entries with GET  /search. A basic API search result consists of a JSON object containing partial lexical information on entries that match the search criteria. To obtain further, more in-depth information for each entry, see GET /entries below.

The entries are returned as objects within the results array, and contain the following fields:

• the unique entry ID
• the source language code
• the headword text
• part of speech
• the different senses with their unique sense ID and definition

Basic search parameters include:

• source ( = global, password, random) – specify which resource to look in.
  the default value is global (the Global series).
• language ( = en, fr, es, de, pl, …) – specify which source language to look in.
• text – specify a headword.

For example,
https://lexicala1.p.rapidapi.com/search?source=global&language=es&text=azul

This query returns all entries in the Spanish core of the Global series with the headword “azul”.

It is possible to look for headwords with specific syntactic criteria:

• pos ( = noun, verb, …) – specify part of speech.
• number ( = singular, plural, …) – specify grammatical number.
• gender ( = masculine, feminine, …) – specify grammatical gender.
• subcategorization ( = masculine, feminine, …) – specify subcategorization.
• monosemous (boolean) – find single sense entries only.
  polysemous (boolean) – find multiple sense entries only.

For example,
https://lexicala1.p.rapidapi.com/search?source=global&language=pl&pos=noun&number=plural

This query returns all entries in the Polish dictionary of the Global series that are plural nouns.

The API also includes two functionalities pertaining to inflected forms and word stems:

• morph (boolean) – searches for the text in both headwords and inflections, including in our supplemental morphological lists. This is based on existing human-curated data and semi-automatic morphological lists.
• analyzed (boolean) – a stemmer algorithm that strips words to their stem, and disregards diacritics and case (uppercase/lowercase).

The morph parameter

setting morph = true looks for all inflected forms (as well as headwords) contained both in KD data and in the external morphological lists.

For example,
https://lexicala1.p.rapidapi.com/search?source=global&language=en&text=houses&morph=true

searching “houses” will return the entry “house” (noun) even though the word “houses” is not an entry in the English dictionary (it is a plural inflection of “house”).

The analyzed parameter

setting analyzed = true looks for inflected forms by applying the stemmer.

For example,
https://lexicala1.p.rapidapi.com/search?source=global&language=en&text=working&analyzed=true

This query returns the entries “working” (adj.), “work” (verb), “work” (noun), “hard-working” (adjective), “working class” (noun), “work on” (verb) and any other entry with the stem “work” in its headword.

The stemmer also disregards diacritics and vocalization (for example in Hebrew and Arabic) and removes case-sensitivity (uppercase/lowercase).

GET /search-entries

Identical to /search but returns full entries rather than abridged versions.

GET /entries, GET /senses – searching by entry (or sense) ID

When searching by parameters (as shown previously), each entry result contains a unique entry ID, and each sense of an entry has its own unique sense ID. Using these IDs, it is possible to obtain more data – various syntactic and semantic information, compositional phrases, usage examples, translations and more – of a single entry (or sense). The entries collection groups together all entries from all different resources (Global, Password, Random House).

The result JSON object contains the field id, source, language, version, related_entries, headword and senses. Following is a brief explanation regarding each field.

• id (string) – the unique dictionary entry ID
• source (string) – the K Dictionaries resource from which the entry is taken (Global, Password, Random House)
• language (string) – a two-character string that is the language code (for a list of all language codes, query GET/languages)
• version (number) – the version of the dictionary the entry is taken from
• related entries (array of strings) – an array containing the IDs of the related entries
• headword (object/array of objects) – contains extensive syntactic and phonetic information of the headword
• senses (array of objects) – contains an elaborate disambiguation of the headword into senses, including syntactic, phonetic and semantic information

some examples:
https://lexicala1.p.rapidapi.com/entries/EN_DE00000789

The query above returns the complete entry “bank” in the Spanish core of the Global series.

https://lexicala1.p.rapidapi.com/entries/PW00003877

The query above returns the complete entry “chair” in the Password series.

https://lexicala1.p.rapidapi.com/entries/RDE00064769_0

The query above returns the complete entry “smile” in the Random House Webster’s college dictionary.

you can also search for a specific sense by its unique sense ID:

https://lexicala1.p.rapidapi.com/senses/EN_SE00001278

The query above returns the second sense of the polysemous entry “bank”. The JSON result for this type of query includes: id (sense id), source, language and entry (entry id).