{"id":19879840,"url":"https://github.com/dylanblokhuis/country-city-api","last_synced_at":"2026-04-09T21:47:51.328Z","repository":{"id":106037318,"uuid":"311393627","full_name":"dylanblokhuis/country-city-api","owner":"dylanblokhuis","description":"Easy web service to fetch all countries including cities","archived":false,"fork":false,"pushed_at":"2020-11-09T18:52:46.000Z","size":19,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-11T17:53:31.431Z","etag":null,"topics":["cities","country-city-api","docker","microservice","nodejs","unece"],"latest_commit_sha":null,"homepage":"","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/dylanblokhuis.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}},"created_at":"2020-11-09T16:10:41.000Z","updated_at":"2020-11-27T14:19:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"b5e8c3cd-4455-4b86-bfce-6a3379034e7c","html_url":"https://github.com/dylanblokhuis/country-city-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanblokhuis%2Fcountry-city-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanblokhuis%2Fcountry-city-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanblokhuis%2Fcountry-city-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanblokhuis%2Fcountry-city-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dylanblokhuis","download_url":"https://codeload.github.com/dylanblokhuis/country-city-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241309105,"owners_count":19941724,"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","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","country-city-api","docker","microservice","nodejs","unece"],"created_at":"2024-11-12T17:09:35.215Z","updated_at":"2025-11-25T03:09:51.203Z","avatar_url":"https://github.com/dylanblokhuis.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Country City API\n\nSimple node.js microservice that provides up-to-date country and city names from [United Nations Economic Commission for Europe](https://unece.org)\n\n\n## Quick start\n\n```npm install```\n\n```npm run start```\n\n## Quick start with Docker\n\nPull latest image from registry \u003cbr /\u003e\n```docker pull dylanblokhuis/country-city-api```\n\nStart the container \u003cbr /\u003e\n```docker run -d -p 3000:3000 dylanblokhuis/country-city-api```\n\nOpen [localhost:3000](http://localhost:3000) to see if it's working.\n\n## Routes\n\n```/countries```\n\n\u003cb\u003eResponse\u003c/b\u003e\n```\n[\n    ...\n    {\n        \"countryCode\": \"NL\",\n        \"url\": \"https://service.unece.org/trade/locode/nl.htm\",\n        \"name\": \"Netherlands\"\n    },\n    {\n        \"countryCode\": \"NC\",\n        \"url\": \"https://service.unece.org/trade/locode/nc.htm\",\n        \"name\": \"New Caledonia\"\n    },\n    {\n        \"countryCode\": \"NZ\",\n        \"url\": \"https://service.unece.org/trade/locode/nz.htm\",\n        \"name\": \"New Zealand\"\n    },\n    ...\n]\n```\n\n\u003cbr/\u003e\n\n```/countries/:countryCode```\n\nExample: ```/countries/NL```\n\n\u003cb\u003eResponse\u003c/b\u003e\n```\n[\n  \"Aa en Hunze\",\n  \"Aalburg\",\n  \"Aalsmeer\",\n  \"Aalsmeerderbrug\",\n  \"Aalst\",\n  \"Aalten\",\n  \"Aan de Zuwe\",\n  \"Aardenburg\",\n  \"Aarlanderveen\",\n  \"Aarle Rixtel\",\n  \"Abbegaasterketting\",\n  \"Abbekerk\",\n  \"Abbenbroek\",\n  ...\n]\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanblokhuis%2Fcountry-city-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdylanblokhuis%2Fcountry-city-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanblokhuis%2Fcountry-city-api/lists"}