Cities Lookup is a city search API that searches over 150,000 global cities to find country codes, population counts, and city size classifications by name. Paid plans add GeoJSON coordinates and custom match limits.
The Cities Lookup API provides a simple, reliable way to integrate cities lookup functionality into your applications. Built for developers who need production-ready cities lookup capabilities without the complexity of building from scratch.
Quick Start
Using JavaScript
async function callCitiesLookupAPI() {
try {
const params = new URLSearchParams({
city: 'San Francisco'
});
const response = await fetch(`https://api.apiverve.com/v1/citieslookup?${params}`, {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
});
const data = await response.json();
console.log(data);
} catch (error) {
console.error('Error:', error);
}
}
callCitiesLookupAPI();Using cURL
curl -X GET "https://api.apiverve.com/v1/citieslookup?city=San%20Francisco" \
-H "x-api-key: YOUR_API_KEY_HERE"Get your API key: https://apiverve.com
📁 For more examples, see the examples folder
Installation
Choose your preferred programming language:
📦 NPM (JavaScript/Node.js)
npm install @apiverve/citieslookupView NPM Package → | Package Code →
🔷 NuGet (.NET/C#)
dotnet add package APIVerve.API.CitiesLookupView NuGet Package → | Package Code →
🐍 Python (PyPI)
pip install apiverve-citieslookupView PyPI Package → | Package Code →
💎 Ruby (RubyGems)
gem install apiverve_citieslookupView RubyGems Package → | Package Code →
🐘 PHP (Packagist)
composer require apiverve/citieslookupView Packagist Package → | Package Code →
🎯 Dart (pub.dev)
dart pub add apiverve_citieslookupView pub.dev Package → | Package Code →
🤖 Android (JitPack)
implementation 'com.github.apiverve:citieslookup-api:1.0.0'🐹 Go
go get github.com/apiverve/citieslookup-api/goWhy Use This API?
| Feature | Benefit |
|---|---|
| Multi-language SDKs | Native packages for JavaScript, Python, C#, Go, and Android |
| Simple Integration | Single API key authentication, consistent response format |
| Production Ready | 99.9% uptime SLA, served from 24 global regions |
| Comprehensive Docs | Full examples, OpenAPI spec, and dedicated support |
Documentation
- 🏠 API Home: Cities Lookup API
- 📚 API Reference: docs.apiverve.com/ref/citieslookup
- 📖 OpenAPI Spec: openapi.yaml
- 💡 Examples: examples/
What Can You Build?
The Cities Lookup API is commonly used for:
- Web Applications - Add cities lookup features to your frontend or backend
- Mobile Apps - Native SDKs for Android development
- Automation - Integrate with n8n, Zapier, or custom workflows
- SaaS Products - Enhance your product with cities lookup capabilities
- Data Pipelines - Process and analyze data at scale
API Reference
Authentication
All requests require an API key in the header:
x-api-key: YOUR_API_KEY_HERE
Get your API key: https://apiverve.com
Response Format
Every APIVerve endpoint returns the same envelope — check status, then read data:
{
"status": "ok",
"error": null,
"data": { ... }
}Example Response
A real response from the Cities Lookup API:
{
"status": "ok",
"error": null,
"data": {
"search": "San Francisco",
"foundCities": [
{
"name": "San Francisco",
"altName": "",
"country": "US",
"countryName": "United States",
"featureCode": "PPLA2",
"population": 874961,
"populationCategory": "major",
"loc": {
"type": "Point",
"coordinates": [
-122.4194,
37.7749
]
}
}
]
}
}Support & Community
- 🏠 API Home: Cities Lookup API
- 💬 Support: https://apiverve.com/contact
- 🐛 Issues: GitHub Issues
- 📖 Documentation: https://docs.apiverve.com
- 🌐 Website: https://apiverve.com
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Security
For security concerns, please review our Security Policy.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
Built with ❤️ by APIVerve
Copyright © 2026 APIVerve. All rights reserved.