API Reference

API Documentation

Complete reference for the Multilingual Dictionary API. Search a word and receive translations across all supported languages.

Base URL

https://my-multilingual-dictionary.deoliste.workers.dev

Authentication

Pass your API key in the Authorization header as a Bearer token. All API requests require authentication except internal web page requests.

Authorization: Bearer <your-api-key>

Don't have an API key? Apply here / 立即申请

GET/api/translation

Search for a word and get multilingual translations. Supports Chinese, English, French, German, Spanish, Portuguese, Italian, Russian, Arabic, Japanese, Korean, and more.

Query Parameters

ParameterTypeDescription
wordstringThe word to search. Supports any language (Chinese, English, French, etc.). Search works for the word itself and its translations across languages.

Response

Returns HTTP 200 with the matching word and all available translations.

Response / 响应示例
{
  "word": "天气",
  "translations": {
    "en": ["weather"],
    "fr": ["temps", "météo"],
    "de": ["Wetter"],
    "es": ["tiempo", "clima"],
    "pt": ["tempo"],
    "it": ["tempo", "meteo"],
    "ru": ["погода", "непогода"],
    "ar": ["طقس", "جو"],
    "ja": ["天気"],
    "ko": ["날씨"]
  }
}

Error Responses

StatusMeaning
400Missing or empty word parameter.
401Invalid or missing API key in the Authorization header.
429Rate limit exceeded. The response body includes the reason and your tier limit.

Cross-Language Search

The API performs a two-step lookup: first it searches for an exact word match. If none is found, it searches all stored translations — so you can search in any language and find the corresponding word in other languages.

Example 1word=hello→ finds “你好” and returns all languages
Example 2word=bonjour→ finds French word and returns all translations
Example 3word=天気→ finds Japanese word and returns all translations

Rate Limits

Rate limits are enforced per API key. Limits reset automatically.

TierPer MinuteMonthly Cap
Free5 requests/min1,000 requests/month
Basic60 requests/min50,000 requests/month
Pro300 requests/min500,000 requests/month

Need higher limits? Contact us at taishangjizie@gmail.com

Code Examples

cURL

curl -H "Authorization: Bearer $YOUR_API_KEY" \
  "https://my-multilingual-dictionary.deoliste.workers.dev/api/translation?word=天气"

JavaScript / Fetch

const response = await fetch(
  'https://my-multilingual-dictionary.deoliste.workers.dev/api/translation?word=weather',
  {
    headers: { 'Authorization': 'Bearer ' + apiKey }
  }
);
const data = await response.json();
console.log(data.word);       // "天气"
console.log(data.translations); // { en: ["weather"], fr: ["temps"], ... }

Python

import requests

resp = requests.get(
    "https://my-multilingual-dictionary.deoliste.workers.dev/api/translation",
    params={"word": "天气"},
    headers={"Authorization": f"Bearer {api_key}"},
)
data = resp.json()
print(data["word"])  # "天气"
print(data["translations"])  # {"en": ["weather"], ...}

Supported Languages

The following language codes may appear in the translations response:

zhChinese (Simplified)
enEnglish
frFrench
deGerman
esSpanish
ptPortuguese
itItalian
ruRussian
arArabic
jaJapanese
koKorean