Turkiye API | Ubeyde Emir Özdemir

What is Turkiye API?

Turkiye API allows you to retrieve data about the provinces and districts of Turkey (all or as much as you want), sort these provinces and districts (by name, license plate number, population, area covered, etc.), filter according to some characteristics of the provinces and districts. It is a REST API prepared for developers that you can do (such as showing only metropolises, showing districts with a population between 100000 and 500000).

What other features does Turkiye API have?

Includes URL Creator, documentation and example usage scenarios.

What is the technology stack of Turkiye API?

Turkiye API is a REST API that uses Node.js and Express.js without any database. (It uses JSON files as a database.) It uses Pug as view engine. It is hosted on Heroku.

What is the story behind Turkiye API?

I created it inspired by Rest Countries API and PokéAPI. What caught my attention was the lack of an API that prepares Turkey's provinces and districts (with some extra information). So, I created the Turkey API.

Do you have any plans for Turkiye API?

Even though it seems like it won't be easy, I'm trying to add the neighborhoods of Turkey. From here you can see which provinces I added neighborhood support for. Apart from this, I want to improve the filter feature of the API (for example, when using one of the /provinces or /provinces/:id routes, we can filter not only the properties of the provinces but also the properties of the districts to which they are connected), add GraphQL support and, in the long run, SQLite. I'm thinking of publishing v2 by using a simple database such as and correcting some parts I don't like, such as provincial regions. I might also try using Docusaurus instead of the current pug template, but I'm not sure about that.