Lexikálně-sémantická databáze češtiny disponuje REST API, které vrací odpovědi ve formátu json.

Vyhledávání v API

API umožňuje vyhledávat slova podle klíčového slova. Vyhledávání je limitováno na maximálně 50 výsledků pro každý slovník.

<aside> 🔗 https://api.najdislovo.cz/v1/search?query={slovo}&limit={pocet_vysledku}

</aside>

Query parametr	Typ	Vysvětlení
query	string	vyhledávané slovo nebo jeho část
limit	number	Počet výsledků pro každý slovník zvlášť, tzn. pokud zadáme 10, bude pro každý slovník limit 10 výsledků. Maximální množství výsledků je 50.
diacritics	boolean	Rozlišovat při vyhledávání diakritiku.
wildcards	boolean	umožňuje použít wildcards k vyhledávání

. matches a single arbitrary character. .? matches either zero or one character. .* matches zero or more characters. .+ matches one or more characters. .{min,max} matches min–max number of characters. |

{
	"query": "list",
  "results_klegr": [
    {
      "sub_entry_id": "47692",
      "entry_id": "175",
      "lemma": "list",
      "count": 1,
      "entry": "Vrstva",
      "lemma_id": "47741",
      "sub_entry": "Vrstva",
      "link": "//api.najdislovo.cz/thesaurus/word/175"
    },
    // ...
  ],
  "results_haller": [
    {
      "sub_entry_id": "1",
      "entry_id": "254",
      "lemma": "List",
      "count": 18,
      "entry": "Rašiti",
      "sub_entry": "Rašiti",
      "sub_entry_search": "rasiti",
      "entry_search": "rasiti",
      "link": "//api.najdislovo.cz/dictionary/word/254/1"
    },
		// ...
  ]
}

Název pole	Datový typ	Vysvětlení
query	string	Hledané heslo
results_klegr	array	seznam slov nalezených v tezauru
entry_id	number	ID hesla
entry	string	Název hesla
sub_entry_id	number	ID podhesla
sub_entry	string	Název podhesla
lemma_id	number	ID prvního slova na kterém byla nalezena shoda s vyhledáváním
lemma	string	první slovo, které bylo vyhledáváno nebo byla nalezena shoda v rámci vyhledávání
count	number	počet shody v rámci daného podhesla
link	string	odkaz na detail hesla
results_haller	array	seznam slov nalezených ve slovníku
entry_id	string	ID hesla
entry	string	Název hesla
sub_entry_id	string	ID podhesla
sub_entry	string	Název podhesla
lemma	string	První slovo na kterém byla nalezena shoda při vyhledávání
count	number	počet nalezených shod v rámci daného podhesla
link	string	odkaz na detail hesla

Získání jednotlivého slova

End-pointy pro jednotlivá slova jsou rozdělené podle typu slovníku.

Tezaurus jazyka českého

Pro nalezení slova v Tezauru jazyka českého je nutné specifikovat ID slova. Vzhledem ke struktuře dat v tezauru je vyhledávání prováděno na úrovni entry.

<aside> 🔗 https://api.najdislovo.cz/v1/thesaurus/word/{id_slova}

</aside>

{
  "section": "Abstraktní vztahy",
	"section_id": 1,
  "sub_section": "Existence",
	"sub_section_id": 1,
	"entry_id": "1"
  "entry": "Existence",
  "references": [
    {
      "entry_id": 3,
      "lemma": "Skutečnost",
      "link": "//api.najdislovo.cz/thesaurus/word/3"
    }
		// ...
  ],
  "xml_content": "<entry xmlns:xsi=\\"<http://www.w3.org/2001/XMLSchema-instance\\>" num=\\"1\\"> ... </entry>",
	"html_content": [
    "<ul id=\\"1\\"> ... </ul>",
	  // ...
	],
}

Název pole	Datový typ	Vysvětlení
section	string	Název sekce, ve které se slovo nachází v tezauru
section_id	number	Číselné označení sekce v tezauru
sub_section	string	Název podsekce, ve které se slovo nachází v tezauru
sub_section_id	number	Číselné označení podsekce v tezauru
entry_id	number	Číselné označení hesla
entry	string	Název hesla
references	array<reference>	Pole obsahující odkazy na podobná slova
xml_content	string	Slovo v XML formátu
html_content	array<string>	List jednotlivých subentries transformovaných do HTML

Český slovník věcný a synonymický

Pro nalezení slova v Českém slovníku věcném a synonymickém je nutné specifikovat ID slova, a nebo ID slova a ID pod-slova. Vzhledem ke struktuře dat ve slovníku je umožněno procházet slovník na úrovni entry i subentry.

Vyhledávání podle entry

<aside> 🔗 Pro vyhledávání na úrovni entry https://api.najdislovo.cz/v1/dictionary/word/{id_entry}

</aside>