Skip to main content
GET
/
v1
/
translations
/
pairs
Translation Pairs
curl --request GET \
  --url https://api.example.com/v1/translations/pairs
{
  "data": [
    {
      "id": 123,
      "source": {},
      "target": {},
      "meaning_id": 123,
      "confidence": 123,
      "bidirectional": true
    }
  ]
}

Request

GET https://api.langdex.co/v1/translations/pairs

Query Parameters

source_lang
string
required
Source language ISO 639-3 code
target_lang
string
required
Target language ISO 639-3 code
limit
integer
default:"50"
Maximum number of results (1-100)
offset
integer
default:"0"
Number of results to skip
min_confidence
number
default:"0.5"
Minimum confidence score (0-1)
pos
string
Filter by part of speech

Response

data
array
Array of translation pair objects

Examples

Get English-Japanese pairs

curl "https://api.langdex.co/v1/translations/pairs?source_lang=eng&target_lang=jpn&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": 999,
      "source": {
        "lexeme_id": 12345,
        "lemma": "water",
        "pos": "noun"
      },
      "target": {
        "lexeme_id": 56789,
        "lemma": "水",
        "reading": "みず",
        "pos": "noun"
      },
      "meaning_id": 98765,
      "confidence": 0.98,
      "bidirectional": true
    },
    {
      "id": 1000,
      "source": {
        "lexeme_id": 12346,
        "lemma": "fire",
        "pos": "noun"
      },
      "target": {
        "lexeme_id": 56790,
        "lemma": "火",
        "reading": "ひ",
        "pos": "noun"
      },
      "meaning_id": 98766,
      "confidence": 0.97,
      "bidirectional": true
    }
  ],
  "meta": {
    "total": 125000,
    "limit": 10,
    "offset": 0
  }
}

Filter by confidence

Get only high-confidence pairs:
curl "https://api.langdex.co/v1/translations/pairs?source_lang=eng&target_lang=deu&min_confidence=0.9" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter by part of speech

Get only verb translations:
curl "https://api.langdex.co/v1/translations/pairs?source_lang=eng&target_lang=fra&pos=verb" \
  -H "Authorization: Bearer YOUR_API_KEY"

Export as TSV

Export translation pairs for offline use:
curl "https://api.langdex.co/v1/translations/pairs/export?source_lang=eng&target_lang=jpn&format=tsv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o translations.tsv
Response (TSV format):
source_lemma	target_lemma	target_reading	pos	confidence
water	水	みず	noun	0.98
fire	火	ひ	noun	0.97
earth	地球	ちきゅう	noun	0.95

Bulk Translation Pairs by Meaning

Get all translations for a specific meaning:
curl "https://api.langdex.co/v1/meanings/98765/translations?target_lang=fra,deu,spa,ita" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "meaning_id": 98765,
  "translations": [
    {"lemma": "eau", "language": "fra", "confidence": 0.98},
    {"lemma": "Wasser", "language": "deu", "confidence": 0.99},
    {"lemma": "agua", "language": "spa", "confidence": 0.97},
    {"lemma": "acqua", "language": "ita", "confidence": 0.96}
  ]
}

Coverage Statistics

Get statistics on translation coverage:
curl "https://api.langdex.co/v1/translations/stats?source_lang=eng&target_lang=jpn" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "source_lang": "eng",
  "target_lang": "jpn",
  "total_pairs": 125000,
  "high_confidence": 98000,
  "by_pos": {
    "noun": 65000,
    "verb": 35000,
    "adj": 18000,
    "adv": 7000
  }
}