US County Search lets you search for U.S. counties by name and returns matching county records and get matching results back in a structured response. Send a query string, and optionally set limit to control how many matches you want returned.
Use it when you need county-level reference data in forms, address workflows, jurisdiction checks, or analytics pipelines. The endpoint is designed for simple lookup flows where a user types a place name such as "Los Angeles" and your app needs to resolve it to county matches without maintaining its own county dataset.
County Search keeps the request surface small: query is required, and limit defaults to 50 with a maximum of 200. The response schema is open-ended, so you should treat the payload as a structured county search result rather than rely on undocumented fields.
If you're building location search, county selection, or administrative-region validation into a product, County Search gives you a focused lookup endpoint for that step in the workflow.
Search counties by query, optionally limiting the number of results.
curl -X GET "http://localhost:8080/dosvak/search-counties?query=Los+Angeles&limit=10" \
-H "apy-token: $APY_TOKEN"Returns a JSON object containing the search query, the number of matching counties, the matching county records, and attribution details.
{
"query": "california",
"count": 5,
"results": [
{
"county_fips": "06037",
"county_name": "Los Angeles County",
"state_name": "California",
"population": 9757179,
"median_household_income": "80794",
"poverty_rate": "13.1",
"unemployment_rate": "5.4"
},
{
"county_fips": "06073",
"county_name": "San Diego County",
"state_name": "California",
"population": 3298799,
"median_household_income": null,
"poverty_rate": null,
"unemployment_rate": null
}
],
"attribution": []
}Loading your default key…Searches for counties using a query string and optionally limits the number of results returned.
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| limit | Integer | No | Maximum number of results to return. Default: 50; minimum: 1; maximum: 200. |
| query | String | Yes | Search term. Minimum length: 2. |
The response includes the search query, the number of matching results, a list of matching counties, and attribution details.
50bad_requestRequired parameter missing or malformed body.
unauthorizedAPI key missing, revoked, or not authorized for this service.
rate_limitedYour plan's per-second rate exceeded. Retry with exponential backoff.
upstream_busyBackend temporarily unavailable. Try again in a few seconds.