GET
/
counties
/
search
curl --request GET \
  --url https://api.shovels.ai/v2/counties/search \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "geo_id": "11",
      "name": "Los Angeles County, CA",
      "state": "CA"
    },
    {
      "geo_id": "12",
      "name": "Harris County, TX",
      "state": "TX"
    },
    {
      "geo_id": "13",
      "name": "Cook County, IL",
      "state": "IL"
    }
  ],
  "page": 1,
  "size": 3
}

Authorizations

X-API-Key
string
header
required

Query Parameters

q
string
required

The name to search for in the county fields.

Response

200
application/json
A list of counties that match the search text.
items
object[]
required

The list of items returned in the response following given criteria.

page
integer
required

The page number of the response.

size
integer
required

The number of items returned in the response.

next_page
integer | null
required

The next page number of the response.