Skip to main content
GET
/
v1
/
lexemes
/
search
Search Lexemes
curl --request GET \
  --url https://api.example.com/v1/lexemes/search
{
  "data": [
    {
      "id": 123,
      "lemma": "<string>",
      "language": "<string>",
      "score": 123
    }
  ]
}

​
Request

GET https://api.langdex.co/v1/lexemes/search

​
Query Parameters

​
q
string
required
Search query
​
lang
string
ISO 639-3 language code to search in
​
limit
integer
default:"20"
Maximum number of results (1-100)
​
pos
string
Filter by part of speech
​
fuzzy
boolean
default:"false"
Enable fuzzy matching
​
include
string
Include related data: senses, pronunciations

​
Response

​
data
array
Array of matching lexemes with relevance scores

​
Examples

​
Search for “water” in English

curl "https://api.langdex.co/v1/lexemes/search?q=water&lang=eng&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "data": [
    {
      "id": 12345,
      "lemma": "water",
      "language": "eng",
      "pos": "noun",
      "score": 1.0,
      "senses": [
        {"id": 111, "gloss": "clear liquid H2O"}
      ]
    },
    {
      "id": 12346,
      "lemma": "water",
      "language": "eng",
      "pos": "verb",
      "score": 0.95,
      "senses": [
        {"id": 222, "gloss": "to pour water on"}
      ]
    },
    {
      "id": 12350,
      "lemma": "waterfall",
      "language": "eng",
      "pos": "noun",
      "score": 0.65
    }
  ],
  "meta": {
    "query": "water",
    "total": 47
  }
}

​
Search in Japanese

curl "https://api.langdex.co/v1/lexemes/search?q=みず&lang=jpn" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Search by reading/romanization

Japanese searches match lemma, reading, and romanization: 
curl "https://api.langdex.co/v1/lexemes/search?q=mizu&lang=jpn" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": 56789,
      "lemma": "水",
      "reading": "みず",
      "romanization": "mizu",
      "score": 1.0
    }
  ]
}
Search across all languages: 
curl "https://api.langdex.co/v1/lexemes/search?q=agua&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {"lemma": "agua", "language": "spa", "score": 1.0},
    {"lemma": "água", "language": "por", "score": 0.95},
    {"lemma": "auga", "language": "glg", "score": 0.85}
  ]
}
Enable fuzzy matching for typo tolerance: 
curl "https://api.langdex.co/v1/lexemes/search?q=watter&lang=eng&fuzzy=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {"lemma": "water", "score": 0.90},
    {"lemma": "wetter", "score": 0.75}
  ]
}

​
Search with definition matching

Search can also match definitions (English queries only): 
curl "https://api.langdex.co/v1/lexemes/search?q=liquid+essential+for+life&lang=jpn" \
  -H "Authorization: Bearer YOUR_API_KEY"