{"id":30297042,"url":"https://github.com/mustafagenc/regions","last_synced_at":"2026-04-10T23:36:01.371Z","repository":{"id":293016530,"uuid":"982625131","full_name":"mustafagenc/regions","owner":"mustafagenc","description":"Bu proje, bölgeler, alt bölgeler, ülkeler, şehirler ve ilçeler gibi coğrafi verileri sağlayan bir API uygulamasıdır.","archived":false,"fork":false,"pushed_at":"2025-07-04T22:48:33.000Z","size":11997,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-08T01:39:08.953Z","etag":null,"topics":["cities","countries","json","netlify","nextjs","regions","states"],"latest_commit_sha":null,"homepage":"https://regionsapi.netlify.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mustafagenc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-13T07:06:23.000Z","updated_at":"2025-07-22T09:47:29.000Z","dependencies_parsed_at":"2025-05-13T09:48:35.820Z","dependency_job_id":null,"html_url":"https://github.com/mustafagenc/regions","commit_stats":null,"previous_names":["mustafagenc/countrystatecity"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mustafagenc/regions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mustafagenc%2Fregions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mustafagenc%2Fregions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mustafagenc%2Fregions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mustafagenc%2Fregions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mustafagenc","download_url":"https://codeload.github.com/mustafagenc/regions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mustafagenc%2Fregions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270800420,"owners_count":24648173,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cities","countries","json","netlify","nextjs","regions","states"],"created_at":"2025-08-17T03:09:42.108Z","updated_at":"2026-04-10T23:35:56.330Z","avatar_url":"https://github.com/mustafagenc.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌍 Regions API [![Netlify](https://img.shields.io/netlify/2c6568b8-5d43-4ec4-b784-72735c518674?logo=netlify\u0026logoColor=#00C7B7\u0026labelColor=545a61)](https://app.netlify.app/sites/regionsapi/deploys) [![Codecov](https://img.shields.io/codecov/c/github/mustafagenc/regions?logo=codecov\u0026logoColor=#F01F7A\u0026labelColor=545a61)](https://codecov.io/gh/mustafagenc/regions) [![CodeFactor Grade](https://img.shields.io/codefactor/grade/github/mustafagenc/regions?logo=codefactor\u0026logoColor=#F44A6A\u0026labelColor=545a61)](https://www.codefactor.io/repository/github/mustafagenc/regions)\n\nBu API projesi, bölge, ülke ve şehir bilgilerini listelemektedir. Veriler, açık kaynaklı ve kapsamlı bir veri tabanı olan [dr5hn/countries-states-cities-database](https://github.com/dr5hn/countries-states-cities-database) projesinden alınmıştır. Bu sayede geniş ve güncel bir coğrafi bilgiye erişim sağlanmaktadır.\n\n[![Postman Collection](public/postman.png) Postman Collection](public/Regions_API.postman_collection.json)\n\n## 🚀 Endpointler\n\nAşağıda API'de bulunan endpointler ve kısa açıklamaları yer almaktadır:\n\n### 1. Bölgeleri Listele\n\n* **Endpoint:** `GET https://regionsapi.netlify.app/regions`\n* **Açıklama:** Tüm bölgelerin listesini getirir.\n  * **Örnek:** [https://regionsapi.netlify.app/regions](https://regionsapi.netlify.app/regions)\n\n### 2. Alt Bölgeleri Listele (Belirli Bir Bölgeye Göre)\n\n* **Endpoint:** `GET https://regionsapi.netlify.app/subregions?region_id=:region_id`\n* **Açıklama:** Belirtilen `region_id`'ye ait alt bölgelerin listesini getirir.\n  * **Örnek:** [https://regionsapi.netlify.app/subregions?region_id=3](https://regionsapi.netlify.app/subregions?region_id=3)\n\n### 3. Ülkeleri Listele\n\n* **Endpoint:** `GET https://regionsapi.netlify.app/countries`\n* **Açıklama:** Tüm ülkelerin listesini getirir.\n  * **Örnek:** [https://regionsapi.netlify.app/countries](https://regionsapi.netlify.app/countries)\n\n### 4. Şehirleri Listele (Belirli Bir Eyalete Göre)\n\n* **Endpoint:** `GET https://regionsapi.netlify.app/cities?state_id=:state_id`\n* **Açıklama:** Belirtilen `state_id`'ye ait şehirlerin listesini getirir.\n  * **Örnek:** [https://regionsapi.netlify.app/cities?state_id=2170](https://regionsapi.netlify.app/cities?state_id=2170)\n\n### 5. Eyaletleri Listele (Belirli Bir Ülkeye Göre)\n\n* **Endpoint:** `GET https://regionsapi.netlify.app/states?country_id=:country_id`\n* **Açıklama:** Belirtilen `country_id`'ye ait eyaletlerin listesini getirir.\n  * **Örnek:** [https://regionsapi.netlify.app/states?country_id=225](https://regionsapi.netlify.app/states?country_id=225)\n\n## 📊 Veri İstatistikleri\n\n* Bölge: 6\n* Alt Bölge: 22\n* Ülke: 250\n* Eyalet/Bölge/Belediye: 5.038\n* Şehir/Kasaba/İlçe: 151.024\n\n```Son Güncellenme Tarihi: 01 Nisan 2025```\n\n## 📄 Lisans\n\nBu proje [MIT](LICENSE) lisansı ile lisanslanmıştır.\n\n## 💡Katkıda Bulunma\n\nKatkıda bulunmak isterseniz, lütfen bir pull request gönderin veya bir issue açın.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmustafagenc%2Fregions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmustafagenc%2Fregions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmustafagenc%2Fregions/lists"}