The County API enables you to look up detailed information for every county in the United States. You can search using various parameters including county name, ZIP code, or state.
https://api.api-ninjas.com/v1/county
Returns details for one or more counties matching the input parameters. For premium users, you can also specify the limit and offset parameters to paginate through results.
At least one of the following parameters (except limit and offset) must be set:
county optionalFull name of the county to search.
zipcode optional5-digit ZIP code to search.
state optional2-letter state code (case-insensitive).
limit optional premium onlyNumber of results to return. Must be between 1 and 30. Default is 1.
offset optional premium onlyNumber of results to offset for pagination. Default is 0.
X-Api-Key requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/county?county=Multnomah CountyHeaders
X-Api-KeyLog in or sign up to get your API Key1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
[
{
"county_name": "Multnomah County",
"county_fips": "41051",
"state_code": "OR",
"state_name": "Oregon",
"latitude": "45.5468",
"longitude": "-122.4149",
"timezone": "America/Los_Angeles",
"zip_codes": [
"97009",
"97010",
"97014",
"97019",
"97024",
"97030",
"97034",
"..."
],
"population": 803863,
"median_age": 38.5
}
]1
2
3
4
5
6
7
8
9
10
import requests
county = 'Multnomah County'
api_url = 'https://api.api-ninjas.com/v1/county?county={}'.format(county)
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
print(response.text)
else:
print("Error:", response.status_code, response.text)If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.