API services

How to register for an API key

1. First you need to go to the API centre homepage. After reaching this page, click on the button that says Register on the top right corner of the screen.
2. At the registration screen, you’ll see instructions to help you in the process of registering. You will need a user name (i.e. the name you’d like to use on our systems), a password and an active e-mail account.
3. After filling the boxes and pressing the Register button on the bottom of the screen, you will be sent an email automatically asking you to validate your account. Click on the link in the email, and use your new account details (user name and password) to log in.
4. You should now see your account’s home screen, with a large message welcoming you. There should be a small button with your user name on it in the top right corner of the screen. Click on this, and then on the Settings button to go to your personal settings.
5. You will now be able to choose from several of our services which use the API system. Choose the program that you would like to use, and then input the necessary information into the fields on the page.
6. You will need to input your website’s URL, a short description of your intentions, and then tick to agree with the terms and conditions. Remember to tick the box that says “The API key will be used on a website” if you would like to to connect and secure your API to a specific website.
   Click on the save button at the bottom of the screen, and your new API key will appear in the relevant box. Congratulations!

Cysill Ar-lein API

The Cysill Ar-lein API allows developers to integrate Cysill’s Welsh grammar and spellchecking features into their software. It’s an easy to use service, and it’s free.

Go to our API Service Centre in order to register and receive an API so that you can start using the service. Here is a guide on how to get an API key.

We’ve provided examples on GitHub on how the API can be used with programming languages like Python.

The examples contain code that provides a simple command line language proofer and uses the Cysill Ar-lein API to check Welsh language Wikipedia articles for spelling and grammar errors.

Welsh Parts-of-Speech Tagger API

The Welsh Parts-of-Speech tagger API allows users to tag Welsh words in a text with their parts of speech (e.g. verbs and mutations) automatically without needing to install any special software on their computer. It’s easy to use, and it’s free.

You can enter any word, phrase or text segment into the API and receive a detailed analysis of each part of speech. For example, if you input “mae hen wlad fy nhadau” into the API, the following analysis will be returned to you:

mae/VBF/- hen/ADJP/- wlad/NF/TM fy/PRONOUN/- nhadau/NPL/TT

In full:

mae (verb form) hen (adjective preceeding the noun) wlad (feminine noun/soft mutation) fy (pronoun) nhadau (plural noun/nasal mutation)

This is the only service of its kind which currently exists through the medium of Welsh on the web, and tags specifically Welsh features, such as mutations.

The service has possible applications in several domains:

• Marketing: identifying personal and place names, and providing further valuable marketing data to businesses that conduct research into customer attitudes on Twitter
• Education: educational applications for schools and coding clubs
• Research: use in academic projects needing to analyse large corpora
• Development: a resource for Welsh medium software developers, including for games and apps

Acknowledgements

Articles or software based on the use of this API should cite:

Jones, D. B., Robertson, P., Prys, G. (2015) Welsh language Parts-of-Speech Tagger API Service [http://techiaith.cymru/api/parts-of-speech-tagger-api/?lang=en] [http://techiaith .cymru/api/tagiwr-rhannau-ymadrodd]

Welsh Lemmatizer API

The Welsh Lemmatizer API allows users to lemmatize any given inflected, mutated and/or conjugated word into its lemma automatically without needing to install any special software on their computer. It’s easy to use, and it’s free.

Go to our API Services in order to register and receive your personal API key in order to use this service. Here is the guide on how to get an API key.

You can enter any word into the API and receive a lemma. For example, if you input “redais” into the API, the lemma “rhedeg” will be returned to you.

This is the only service of its kind which currently exists for Welsh. The service has possible applications in several domains including online dictionary websites.

Acknowledgements

Articles or software based on the use of this APIshould cite:

Jones, D. B., Robertson, P., Prys, G. (2015) Welsh language Lemmatizer API Service [http://techiaith.cymru/api/lemmatizer/?lang=en] [http://techiaith .cymru/api/lemateiddiwr /]

Welsh Text to Speech API

The online text-to-speech API allows you to integrate a synthetic Welsh voice into your software, apps, and websites. It’s easy to use and completely free!

Here’s an example of how to use the API within an HTML web page:

<script type="text/javascript">

function llefaru() {

    var testun = document.getElementById('llais').value.trim();

    var audioElement = document.createElement('audio');

    var url = "https://api.techiaith.org/festival/v1?api_key=7e1136b1-c33b-4e84-a87e-0a0a4ee08cd3&text=" + encodeURI(testun);

    audioElement.setAttribute('src', url);

    audioElement.play();

}

</script>

<button>Chwarae / Play</button>

Visit our APIs services center to register and receive an API key to be able to use the service. Here are instructions on how to receive an API key.

We have provided examples on GitHub of how the API can be used with programming languages ​​such as Python and Javascript.

Language Detection API