Country Lookup API
Country Lookup is a simple tool for looking up country data. It returns the country name, capital, and more.
Live Test API
Try out the Country Lookup with a live request and see the response in real-time.
API Request
API Response
{
"status": "ok",
"error": null,
"data": {
"search": "USA",
"countries": [
{
"name": {
"common": "United States",
"official": "United States of America",
"native": {
"eng": {
"official": "United States of America",
"common": "United States"
}
}
},
"tld": [
".us"
],
"cca2": "US",
"ccn3": "840",
"cca3": "USA",
"cioc": "USA",
"independent": true,
"status": "officially-assigned",
"currencies": {
"USD": {
"name": "United States dollar",
"symbol": "$"
}
},
"capital": [
"Washington D.C."
],
"altSpellings": [
"US",
"USA",
"United States of America"
],
"region": "Americas",
"subregion": "North America",
"languages": {
"eng": "English"
},
"latlng": [
38,
-97
],
"landlocked": false,
"borders": [
"CAN",
"MEX"
],
"area": 9372610,
"flag": "🇺🇸",
"majorCities": [
"Akron",
"Albany",
"Albuquerque",
"Alexandria",
"Allentown",
"Alpharetta",
"Anaheim",
"Anchorage",
"Ann Arbor",
"Arlington",
"Arlington",
"Asheville",
"Astoria",
"Atlanta",
"Aurora",
"Austin",
"Bakersfield",
"Baltimore",
"Baton Rouge",
"Beaverton",
"Bellevue",
"Berkeley",
"Beverly Hills",
"Birmingham",
"Boca Raton",
"Boise",
"Boston",
"Boulder",
"Bronx",
"Brooklyn",
"Buffalo",
"Cambridge",
"Carlsbad",
"Cary",
"Chandler",
"Charleston",
"Charlotte",
"Charlottesville",
"Chattanooga",
"Cherry Hill",
"Chicago",
"Cincinnati",
"Clearwater",
"Cleveland",
"Colorado Springs",
"Columbia",
"Columbia",
"Columbus",
"Costa Mesa",
"Dallas"
]
}
]
}
}Multiple Access Methods
REST API with multiple response formats plus GraphQL support
JSON
JavaScript Object Notation
XML
Extensible Markup Language
YAML
Human-readable data format
GraphQL
Query language for APIs
GraphQL Support
Access most of our API library through our unified GraphQL interface. Query multiple APIs in a single request with flexible field selection.Learn more about GraphQL →
Skip the HTTP calls. Use our official packages
Integrate faster with type-safe SDKs and comprehensive documentation
Similar APIs
Explore other geography APIs that complement the Country Lookup
Frequently Asked Questions
Get answers to common questions about the Country Lookup
How do I get started with this API?
Getting started is simple! Sign up for a free account, get your API key, and start making requests to our REST endpoints. We provide comprehensive documentation and code examples to help you integrate quickly.
What response formats are supported?
We support JSON (default), XML, and YAML response formats. Simply add the format parameter to your request with values 'json', 'xml', or 'yaml'. All formats contain the same comprehensive data.
Are there usage limits on the free tier?
The free tier includes 50 tokens per month with a rate limit of 10 requests per minute. Pro plans offer higher limits and enterprise plans provide unlimited usage with priority support.
How do I authenticate API requests?
Include your API key in the request header as X-API-Key: your_key_here or as a query parameter ?key=your_key. All requests are made over HTTPS for security.
Ready to integrate Country Lookup?
Join thousands of developers building amazing applications with reliable API data. Get started with your free API key today.