Save over 30% when you subscribe to an annual subscription plan!

County API

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.

/v1/county GET

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.

Parameters

At least one of the following parameters (except limit and offset) must be set:

  • county  optional

    Full name of the county to search.

  • zipcode  optional

    5-digit ZIP code to search.

  • state  optional

    2-letter state code (case-insensitive).

  • limit  optional  premium only

    Number of results to return. Must be between 1 and 30. Default is 1.

  • offset  optional  premium only

    Number of results to offset for pagination. Default is 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

county
https://api.api-ninjas.com/v1/county?county=Multnomah County

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 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 } ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/county?name=Los%20Angeles" \ -H "X-Api-Key: YOUR_API_KEY"

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.