Holiday Sale! Get over 30% off when you subscribe to an annual 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.

(4.6)

From 2,421 users

3,000+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
406ms439ms499ms815ms1227ms

Didn't find what you were looking for? Suggest an improvement

/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.

Response

Returns an array of county objects, each containing:

  • county_name

    Name of the county.

  • county_fips

    FIPS (Federal Information Processing Standards) code for the county.

  • state_code

    2-letter state code.

  • state_name

    Full name of the state.

  • latitude

    Latitude coordinate of the county.

  • longitude

    Longitude coordinate of the county.

  • timezone

    Timezone of the county (e.g., "America/Los_Angeles").

  • zip_codes

    Array of ZIP codes within the county.

  • population

    County population count.

  • median_age

    Median age of the county population.

Sample Request Live Demo!

county

Try this API endpoint with all available parameters in our API playground

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.