{"openapi":"3.1.0","info":{"title":"Example Sentences API","version":"1.0.0","description":"Real example sentences with human translations as an API — powered by Tatoeba, the large collaborative corpus of millions of sentences in hundreds of languages, each linked to translations contributed and reviewed by real people (not machine translation). Search for sentences containing a word or phrase in one language and get how they are actually translated into another — perfect for seeing a word \"in the wild\", building vocabulary and flashcards, or as a human-quality translation aid. Look up any sentence by id to get its full set of translations. From \"good morning\" in English to its German, French, Spanish, Japanese or Mandarin equivalents, across ISO-639-3 languages, it is ideal for language-learning, vocabulary, flashcard, dictionary-companion and linguistics applications. A human-translated example-sentence corpus — distinct from dictionaries (definitions), machine translation and word APIs. Open data from Tatoeba (CC-BY 2.0 FR / CC0).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tatoeba-api","description":"oanor gateway"}],"tags":[{"name":"Sentences"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Sentences"],"summary":"Example sentences with translations","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Word or phrase to search","schema":{"type":"string"},"example":"good morning"},{"name":"from","in":"query","required":false,"description":"Source language (ISO-639-3), e.g. eng","schema":{"type":"string"},"example":"eng"},{"name":"to","in":"query","required":false,"description":"Translation language (ISO-639-3), e.g. deu","schema":{"type":"string"},"example":"deu"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50, default 10)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"deu","from":"eng","count":10,"query":"good morning","total":105,"sentences":[{"id":2258234,"lang":"eng","text":"Good morning.","lang_name":"English","translations":[{"id":382123,"lang":"deu","text":"Guten Morgen!","lang_name":"German"},{"id":4325231,"lang":"deu","text":"Guten Morgen.","lang_name":"German"},{"id":380701,"lang":"deu","text":"Hallo!","lang_name":"German"},{"id":659813,"lang":"deu","text":"Grüß Gott!","lang_name":"German"},{"id":676082,"lang":"deu","text":"Guten Tag!","lang_name":"German"},{"id":3631301,"lang":"deu","text":"Guten Tag.","lang_name":"German"},{"id":438751,"lang":"deu","text":"Guten Abend!","lang_name":"German"},{"id":2346428,"lang":"deu","text":"Ich grüße dich.","lang_name":"German"},{"id":1531832,"lang":"deu","text":"Servus.","lang_name":"German"},{"id":10298103,"lang":"deu","text":"Hallo.","lang_name":"German"},{"id":10298104,"lang":"deu","text":"Morgen.","lang_name":"German"},{"id":10298105,"lang":"deu","text":"Grüß Gott.","lang_name":"German"},{"id":1285974,"lang":"deu","text":"Tschüß.","lang_name":"German"},{"id":1285975,"lang":"deu","text":"Tschau.","lang_name":"German"},{"id":1408151,"lang":"deu","text":"Wiedersehen.","lang_name":"German"},{"id":1531835,"lang":"deu","text":"Grüezi.","lang_name":"German"},{"id":4238069,"lang":"deu","text":"Auf Wiedersehen.","lang_name":"German"},{"id":4806337,"lang":"deu","text":"Gute Nacht.","lang_name":"German"}]},{"id":329713,"lang":"eng","text":"Good morning!","lang_name":"English","translations":[{"id":382123,"lang":"deu","text":"Guten Morgen!","lang_name":"German"},{"id":380701,"lang":"deu","text":"Hallo!","lang_name":"German"},{"id":659813,"lang":"deu","text":"Grüß Gott!","lang_name":"German"},{"id":676082,"lang":"deu","text":"Guten Tag!","lang_name":"German"},{"id":3631301,"lang":"deu","text":"Guten Tag.","lang_name":"German"},{"id":4325231,"lang":"deu","text":"Guten Morgen.","lang_name":"German"},{"id":10298104,"lang":"deu","text":"Morgen.","lang_name":"German"},{"id":5224507,"lang":"deu","text":"Ich wünsche einen guten Morgen!","lang_name":"German"}]},{"id":11643322,"lang":"eng","text":"Good morning, everybody!","lang_name":"English","translations":[{"id":6534121,"lang":"deu","text":"Guten Morgen, alle zusammen.","lang_name":"German"}]},{"id":11531555,"lang":"eng","text":"Good morning, sunshine!","lang_name":"English","translations":[{"id":12651442,"lang":"deu","text":"Guten Morgen, mein Sonnenschein!","lang_name":"German"}]},{"id":11137121,"lang":"eng","text":"Good morning, America!","lang_name":"English","translations":[{"id":11905078,"lang":"deu","text":"Guten Morgen, Amerika!","lang_name":"German"}]},{"id":10502804,"lang":"eng","text":"Good morning, everyone!","lang_name":"English","translations":[{"id":397504,"lang":"deu","text":"Guten Morgen zusammen.","lang_name":"German"},{"id":5020382,"lang":"deu","text":"Guten Morgen, alle zusammen!","lang_name":"German"},{"id":6534121,"lang":"deu","text":"Guten Morgen, alle zusammen.","lang_name":"German"},{"id":8500974,"lang":"deu","text":"Guten Morgen alle zusammen!","lang_name":"German"},{"id":6701555,"lang":"deu","text":"Guten Morgen allerseits!","lang_name":"German"}]},{"id":9819687,"lang":"eng","text":"\"Good morning.\" \"Coffee.\"","lang_name":"English","translations":[{"id":12476572,"lang":"deu","text":"„Guten Morgen.“ „Kaffee.“","lang_name":"German"}]},{"id":9489288,"lang":"eng","text":"Good morning, Tatoeba.","lang_name":"English","translations":[{"id":13678478,"lang":"deu","text":"Guten Morgen, Tatoeba!","lang_name":"German"}]},{"id":8406794,"lang":"eng","text":"Good morning, Tom!","lang_name":"English","translations":[{"id":6471469,"lang":"deu","text":"Guten Morgen, Tom.","lang_name":"German"},{"id":8036585,"lang":"deu","text":"Guten Tag, Tom!","lang_name":"German"},{"id":406777,"lang":"deu","text":"Hallo, Tom.","lang_name":"German"},{"id":3298512,"lang":"deu","text":"Hallo, Tom!","lang_name":"German"}]},{"id":8160887,"lang":"eng","text":"Good morning, grandpa!","lang_name":"English","translations":[{"id":5020183,"lang":"deu","text":"Guten Morgen, Großvater!","lang_name":"German"},{"id":5020182,"lang":"deu","text":"Guten Tag, Großvater!","lang_name":"German"},{"id":5020184,"lang":"deu","text":"Guten Abend, Großvater!","lang_name":"German"},{"id":5020185,"lang":"deu","text":"Hallo Großvater!","lang_name":"German"}]}]},"meta":{"timestamp":"2026-06-01T16:22:57.304Z","request_id":"270ef2df-2417-4bd3-ab7c-853dfaf1116e"},"status":"ok","message":"Sentences retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/sentence":{"get":{"operationId":"get_v1_sentence","tags":["Sentences"],"summary":"A sentence + its translations","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"A Tatoeba sentence id (from /v1/search)","schema":{"type":"string"},"example":"2258234"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sentence":{"id":2258234,"lang":"eng","text":"Good morning.","license":"CC BY 2.0 FR","lang_name":"English","based_on_id":0,"translations":[{"id":2481703,"lang":"abk","text":"Шьыжьбзиа!","lang_name":"Abkhaz"},{"id":849446,"lang":"afr","text":"Goeie môre.","lang_name":"Afrikaans"},{"id":6983687,"lang":"akl","text":"Mayad nga agahon.","lang_name":"Aklanon"},{"id":13192426,"lang":"amh","text":"Endemin aderk /እንደ ምን አደርክ/","lang_name":"Amharic"},{"id":7482088,"lang":"ara","text":"صباح الخير","lang_name":"Arabic"},{"id":7830602,"lang":"arg","text":"Buen diya.","lang_name":"Aragonese"},{"id":5741567,"lang":"aze","text":"Sabahın xeyir.","lang_name":"Azerbaijani"},{"id":13350498,"lang":"aze","text":"Sabahınız xeyir.","lang_name":"Azerbaijani"},{"id":11127656,"lang":"bal","text":"Sohb wash bát","lang_name":"Baluchi"},{"id":13333540,"lang":"bcl","text":"Marhay na aga.","lang_name":"Central Bikol"},{"id":8004348,"lang":"bel","text":"Добрай раніцы!","lang_name":"Belarusian"},{"id":3230444,"lang":"ben","text":"সুপ্রভাত।","lang_name":"Bengali"},{"id":855310,"lang":"ces","text":"Dobré ráno!","lang_name":"Czech"},{"id":871489,"lang":"ces","text":"Dobré ráno.","lang_name":"Czech"},{"id":7910341,"lang":"cha","text":"Buenas dihas.","lang_name":"Chamorro"},{"id":335381,"lang":"cmn","text":"早上好！","lang_name":"Mandarin Chinese"},{"id":2193615,"lang":"cmn","text":"早上好。","lang_name":"Mandarin Chinese"},{"id":3018757,"lang":"cor","text":"Myttin da!","lang_name":"Cornish"},{"id":6443789,"lang":"cym","text":"Bore da.","lang_name":"Welsh"},{"id":13842349,"lang":"cyo","text":"Mayad nga timprano.","lang_name":"Cuyonon"},{"id":2606610,"lang":"dan","text":"Godmorgen!","lang_name":"Danish"},{"id":10814885,"lang":"dan","text":"Godmorgen.","lang_name":"Danish"},{"id":382123,"lang":"deu","text":"Guten Morgen!","lang_name":"German"},{"id":4325231,"lang":"deu","text":"Guten Morgen.","lang_name":"German"},{"id":9979166,"lang":"dsb","text":"Dobre zajtšo!","lang_name":"Lower Sorbian"},{"id":9979167,"lang":"dsb","text":"Dobrejtšo!","lang_name":"Lower Sorbian"},{"id":1370108,"lang":"ell","text":"Καλημέρα.","lang_name":"Greek"},{"id":329713,"lang":"eng","text":"Good morning!","lang_name":"English"},{"id":442402,"lang":"epo","text":"Bonan matenon!","lang_name":"Esperanto"},{"id":4457140,"lang":"fao","text":"Góðan morgun.","lang_name":"Faroese"},{"id":7950124,"lang":"fin","text":"Hyvää huomenta.","lang_name":"Finnish"},{"id":373345,"lang":"fra","text":"Bonjour !","lang_name":"French"},{"id":3557547,"lang":"fra","text":"Bonjour.","lang_name":"French"},{"id":4189469,"lang":"gla","text":"Madainn mhath!","lang_name":"Scottish Gaelic"},{"id":8109644,"lang":"gla","text":"Madainn mhath.","lang_name":"Scottish Gaelic"},{"id":7872529,"lang":"gos","text":"Moi.","lang_name":"Gronings"},{"id":8158602,"lang":"gos","text":"Goimörgen.","lang_name":"Gronings"},{"id":1489285,"lang":"heb","text":"בוקר טוב!","lang_name":"Hebrew"},{"id":11377014,"lang":"hoc","text":"𑢾𑣁𑣋𑣃𑣓 𑣞𑣂𑣕𑣁𑣄.","lang_name":"Ho"},{"id":9833374,"lang":"hsb","text":"Dobre ranje!","lang_name":"Upper Sorbian"}]}},"meta":{"timestamp":"2026-06-01T16:22:59.157Z","request_id":"e78ca192-8c49-4d64-a6ac-63e45ebf97e9"},"status":"ok","message":"Sentence retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue, languages & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Tatoeba is a large, community-built corpus of example sentences in hundreds of languages, each linked to human-contributed translations (not machine translation). /v1/search?q=good morning&from=eng&to=deu = find example sentences containing a word or phrase in the 'from' language and get their translations, optionally restricted to a 'to' language — each result has the sentence id, language, text and a list of translations (language + text); omit from/to to search across all languages. /v1/sentence?id=2258234 = a single sentence with its id, language, text, license and all its translations. Language codes are ISO 639-3 (eng, deu, fra, spa, jpn, cmn, …; see common_languages). Data from Tatoeba (CC-BY 2.0 FR / CC0). A human-translated example-sentence corpus — distinct from dictionaries (definitions), machine translation and word APIs. Ideal for language-learning, vocabulary, flashcard, translation-aid and linguistics tools.","source":"Tatoeba — collaborative example-sentence corpus (tatoeba.org)","endpoints":["/v1/search","/v1/sentence","/v1/meta"],"common_languages":{"ara":"Arabic","cmn":"Mandarin Chinese","deu":"German","ell":"Greek","eng":"English","fra":"French","ita":"Italian","jpn":"Japanese","kor":"Korean","nld":"Dutch","pol":"Polish","por":"Portuguese","rus":"Russian","spa":"Spanish","tur":"Turkish"}},"meta":{"timestamp":"2026-06-01T16:22:59.236Z","request_id":"f6820e8e-91cb-4766-ad25-d7b0d3ce01a0"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3100,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":770,"monthly_call_quota":64000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2420,"monthly_call_quota":300000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6350,"monthly_call_quota":1050000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tatoeba-api"}