OPUS-API • HTTP interface

OPUS API endpoint

Query OPUS corpora and languages using simple URL parameters. Call this endpoint directly from your code, or explore it in the browser.

Query parameters

corpus

Name of the corpus you want to query. For example: OpenSubtitles.

source

Source language code (e.g. en, fi).

target

Target language code. Combine with source to query language pairs.

preprocessing

Preprocessing type, for example xml.

version

Corpus version. Use latest to always get the latest release.

corpora

Set to True to list available corpora instead of querying a specific one.

languages

Set to True to list available languages, optionally filtered by corpus or source.

Examples

Query corpora
corpus source target preprocessing version
https://opus.nlpl.eu/opusapi?corpus=OpenSubtitles&source=en&target=fi&preprocessing=xml&version=latest
List available corpora
corpora=True
https://opus.nlpl.eu/opusapi?corpora=True
List all languages
languages=True
https://opus.nlpl.eu/opusapi?languages=True
Languages for a corpus
languages=True corpus
https://opus.nlpl.eu/opusapi?languages=True&corpus=OpenSubtitles
Target languages for a source
languages=True source
https://opus.nlpl.eu/opusapi?languages=True&source=fi
Target languages for a source in a corpus
languages=True corpus source
https://opus.nlpl.eu/opusapi?languages=True&corpus=OpenSubtitles&source=fi

All responses are returned as JSON. You can call this endpoint from curl, Python, JavaScript, or any HTTP client.

Tip: opening /opusapi/?... in the browser is a quick way to explore responses while developing.