County Data Lookup API
Overview
To use County Data Lookup, you need an API key. You can get one by creating a free account and visiting your dashboard.
GET Endpoint
https://api.apiverve.com/v1/countydataExample
How to call the County Data Lookup API in different programming languages.
curl -X GET \
"https://api.apiverve.com/v1/countydata?state=MO&county=Jackson" \
-H "X-API-Key: your_api_key_here"const response = await fetch('https://api.apiverve.com/v1/countydata?state=MO&county=Jackson', {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);import requests
headers = {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
response = requests.get('https://api.apiverve.com/v1/countydata?state=MO&county=Jackson', headers=headers)
data = response.json()
print(data)package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/countydata?state=MO&county=Jackson", nil)
req.Header.Set("X-API-Key", "your_api_key_here")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}{
"status": "ok",
"error": null,
"data": {
"name": "jackson county",
"state": "MO",
"age": {
"0-4": 0.0644100874666257,
"5-9": 0.06532756955438819,
"10-14": 0.06595060390235714,
"15-19": 0.05967616438434107,
"20-24": 0.059725950234064615,
"25-29": 0.08192474939936928,
"30-34": 0.07523353119652466,
"35-39": 0.06868029092005673,
"40-44": 0.05831060964906666,
"45-49": 0.058805623240603636,
"50-54": 0.05858087569042305,
"55-59": 0.0674783182624454,
"60-64": 0.06208437705811146,
"65-69": 0.05099777955110233,
"70-74": 0.03891546504962227,
"75-79": 0.026437708656052324,
"80-84": 0.01748905778145719,
"85+": 0.01997123800338828
},
"male": 339932,
"female": 363079,
"health": {
"poorhealth": 20.588989742,
"physicallyunhealthydays": 4.247736361,
"mentallyunhealthydays": 4.8111015035,
"lowbirthweightpercent": 9.1518749808,
"smokerspercent": 20.957241772,
"obesitypercent": 31.5,
"foodenvindex": 7.5,
"physicallyinactivepercent": 23.2,
"excessivedrinkingpercent": 18.940103365,
"alcoholimpaireddrivingdeaths": 152,
"teenbirthrate": 31.109351559,
"uninsured": 12.486314662,
"withannualmammogram": 45,
"vaccinated": 51,
"childreninpoverty": 19.6,
"80thpercentileincome": 108296,
"20thpercentileincome": 23275,
"childreninsingleparenthouseholds": 33.224850811,
"violentcrimerate": 941.43198334,
"averagedailypm25": 9.1,
"severehousingproblems": 15.347550638,
"drivealonetowork": 83.470246386,
"longcommutedrivesalone": 33.7
},
"longitude": -94.34749665503394,
"latitude": 39.016701918102484,
"education": {
"lessthanhighschool": 9.4,
"highschool": 28.3,
"somecollege": 30.7,
"bachelors": 31.6
},
"zipcodes": [
"64137",
"64111",
"64053",
"64055",
"64064",
"64029",
"64106",
"64108",
"64034",
"64118",
"64136",
"64139",
"64125",
"64030",
"64014",
"64066",
"64080",
"64123",
"64131",
"64145",
"64128",
"64121",
"64170",
"64050",
"64057",
"64133",
"64109",
"64130",
"64134",
"64129",
"64158",
"64163",
"64070",
"64102",
"64105",
"64086",
"64101",
"64124",
"64157",
"64088",
"64061",
"64051",
"64002",
"64081",
"64013",
"64016",
"64112",
"64114",
"64110",
"64152",
"64127",
"64147",
"64120",
"64146",
"64199",
"64058",
"64054",
"64074",
"64119",
"64138",
"64149",
"64156",
"64132",
"64171",
"64148",
"64141",
"64999",
"64052",
"64015",
"64063",
"64075",
"64056",
"64082",
"64113",
"64155",
"64126",
"64197",
"64065",
"64198"
],
"lifeexpectancy": 77.19,
"avgincome": 47054,
"povertyrate": 13.7,
"costofliving": {
"livingwage": 14.55,
"foodcosts": 3246,
"medicalcosts": 2681,
"housingcosts": 8136,
"taxcosts": 6263
},
"landareakm2": 1565.601892,
"areakm2": 1596.319707
}
}Authentication
The County Data Lookup API requires authentication via API key. Include your API key in the request header:
X-API-Key: your_api_key_hereInteractive API Playground
Test the County Data Lookup API directly in your browser with live requests and responses.
Parameters
The following parameters are available for the County Data Lookup API:
Get County Data
| Parameter | Type | Required | Description | Default | Example |
|---|---|---|---|---|---|
state | string | required | The two letter name of the US state the county is in (e.g., MO) Length: 2 - 2 chars | - | |
county | string | required | The name of the US county to get data about (e.g. Jackson) | - |
Response
The County Data Lookup API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.
Other Response Formats
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>ok</status>
<error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<data>
<name>jackson county</name>
<state>MO</state>
<age>
<0_4>0.0644100874666257</0_4>
<5_9>0.06532756955438819</5_9>
<10_14>0.06595060390235714</10_14>
<15_19>0.05967616438434107</15_19>
<20_24>0.059725950234064615</20_24>
<25_29>0.08192474939936928</25_29>
<30_34>0.07523353119652466</30_34>
<35_39>0.06868029092005673</35_39>
<40_44>0.05831060964906666</40_44>
<45_49>0.058805623240603636</45_49>
<50_54>0.05858087569042305</50_54>
<55_59>0.0674783182624454</55_59>
<60_64>0.06208437705811146</60_64>
<65_69>0.05099777955110233</65_69>
<70_74>0.03891546504962227</70_74>
<75_79>0.026437708656052324</75_79>
<80_84>0.01748905778145719</80_84>
<85_>0.01997123800338828</85_>
</age>
<male>339932</male>
<female>363079</female>
<health>
<poorhealth>20.588989742</poorhealth>
<physicallyunhealthydays>4.247736361</physicallyunhealthydays>
<mentallyunhealthydays>4.8111015035</mentallyunhealthydays>
<lowbirthweightpercent>9.1518749808</lowbirthweightpercent>
<smokerspercent>20.957241772</smokerspercent>
<obesitypercent>31.5</obesitypercent>
<foodenvindex>7.5</foodenvindex>
<physicallyinactivepercent>23.2</physicallyinactivepercent>
<excessivedrinkingpercent>18.940103365</excessivedrinkingpercent>
<alcoholimpaireddrivingdeaths>152</alcoholimpaireddrivingdeaths>
<teenbirthrate>31.109351559</teenbirthrate>
<uninsured>12.486314662</uninsured>
<withannualmammogram>45</withannualmammogram>
<vaccinated>51</vaccinated>
<childreninpoverty>19.6</childreninpoverty>
<80thpercentileincome>108296</80thpercentileincome>
<20thpercentileincome>23275</20thpercentileincome>
<childreninsingleparenthouseholds>33.224850811</childreninsingleparenthouseholds>
<violentcrimerate>941.43198334</violentcrimerate>
<averagedailypm25>9.1</averagedailypm25>
<severehousingproblems>15.347550638</severehousingproblems>
<drivealonetowork>83.470246386</drivealonetowork>
<longcommutedrivesalone>33.7</longcommutedrivesalone>
</health>
<longitude>-94.34749665503394</longitude>
<latitude>39.016701918102484</latitude>
<education>
<lessthanhighschool>9.4</lessthanhighschool>
<highschool>28.3</highschool>
<somecollege>30.7</somecollege>
<bachelors>31.6</bachelors>
</education>
<zipcodes>
<zipcode>64137</zipcode>
<zipcode>64111</zipcode>
<zipcode>64053</zipcode>
<zipcode>64055</zipcode>
<zipcode>64064</zipcode>
<zipcode>64029</zipcode>
<zipcode>64106</zipcode>
<zipcode>64108</zipcode>
<zipcode>64034</zipcode>
<zipcode>64118</zipcode>
<zipcode>64136</zipcode>
<zipcode>64139</zipcode>
<zipcode>64125</zipcode>
<zipcode>64030</zipcode>
<zipcode>64014</zipcode>
<zipcode>64066</zipcode>
<zipcode>64080</zipcode>
<zipcode>64123</zipcode>
<zipcode>64131</zipcode>
<zipcode>64145</zipcode>
<zipcode>64128</zipcode>
<zipcode>64121</zipcode>
<zipcode>64170</zipcode>
<zipcode>64050</zipcode>
<zipcode>64057</zipcode>
<zipcode>64133</zipcode>
<zipcode>64109</zipcode>
<zipcode>64130</zipcode>
<zipcode>64134</zipcode>
<zipcode>64129</zipcode>
<zipcode>64158</zipcode>
<zipcode>64163</zipcode>
<zipcode>64070</zipcode>
<zipcode>64102</zipcode>
<zipcode>64105</zipcode>
<zipcode>64086</zipcode>
<zipcode>64101</zipcode>
<zipcode>64124</zipcode>
<zipcode>64157</zipcode>
<zipcode>64088</zipcode>
<zipcode>64061</zipcode>
<zipcode>64051</zipcode>
<zipcode>64002</zipcode>
<zipcode>64081</zipcode>
<zipcode>64013</zipcode>
<zipcode>64016</zipcode>
<zipcode>64112</zipcode>
<zipcode>64114</zipcode>
<zipcode>64110</zipcode>
<zipcode>64152</zipcode>
<zipcode>64127</zipcode>
<zipcode>64147</zipcode>
<zipcode>64120</zipcode>
<zipcode>64146</zipcode>
<zipcode>64199</zipcode>
<zipcode>64058</zipcode>
<zipcode>64054</zipcode>
<zipcode>64074</zipcode>
<zipcode>64119</zipcode>
<zipcode>64138</zipcode>
<zipcode>64149</zipcode>
<zipcode>64156</zipcode>
<zipcode>64132</zipcode>
<zipcode>64171</zipcode>
<zipcode>64148</zipcode>
<zipcode>64141</zipcode>
<zipcode>64999</zipcode>
<zipcode>64052</zipcode>
<zipcode>64015</zipcode>
<zipcode>64063</zipcode>
<zipcode>64075</zipcode>
<zipcode>64056</zipcode>
<zipcode>64082</zipcode>
<zipcode>64113</zipcode>
<zipcode>64155</zipcode>
<zipcode>64126</zipcode>
<zipcode>64197</zipcode>
<zipcode>64065</zipcode>
<zipcode>64198</zipcode>
</zipcodes>
<lifeexpectancy>77.19</lifeexpectancy>
<avgincome>47054</avgincome>
<povertyrate>13.7</povertyrate>
<costofliving>
<livingwage>14.55</livingwage>
<foodcosts>3246</foodcosts>
<medicalcosts>2681</medicalcosts>
<housingcosts>8136</housingcosts>
<taxcosts>6263</taxcosts>
</costofliving>
<landareakm2>1565.601892</landareakm2>
<areakm2>1596.319707</areakm2>
</data>
</response>
status: ok
error: null
data:
name: jackson county
state: MO
age:
0-4: 0.0644100874666257
5-9: 0.06532756955438819
10-14: 0.06595060390235714
15-19: 0.05967616438434107
20-24: 0.059725950234064615
25-29: 0.08192474939936928
30-34: 0.07523353119652466
35-39: 0.06868029092005673
40-44: 0.05831060964906666
45-49: 0.058805623240603636
50-54: 0.05858087569042305
55-59: 0.0674783182624454
60-64: 0.06208437705811146
65-69: 0.05099777955110233
70-74: 0.03891546504962227
75-79: 0.026437708656052324
80-84: 0.01748905778145719
85+: 0.01997123800338828
male: 339932
female: 363079
health:
poorhealth: 20.588989742
physicallyunhealthydays: 4.247736361
mentallyunhealthydays: 4.8111015035
lowbirthweightpercent: 9.1518749808
smokerspercent: 20.957241772
obesitypercent: 31.5
foodenvindex: 7.5
physicallyinactivepercent: 23.2
excessivedrinkingpercent: 18.940103365
alcoholimpaireddrivingdeaths: 152
teenbirthrate: 31.109351559
uninsured: 12.486314662
withannualmammogram: 45
vaccinated: 51
childreninpoverty: 19.6
80thpercentileincome: 108296
20thpercentileincome: 23275
childreninsingleparenthouseholds: 33.224850811
violentcrimerate: 941.43198334
averagedailypm25: 9.1
severehousingproblems: 15.347550638
drivealonetowork: 83.470246386
longcommutedrivesalone: 33.7
longitude: -94.34749665503394
latitude: 39.016701918102484
education:
lessthanhighschool: 9.4
highschool: 28.3
somecollege: 30.7
bachelors: 31.6
zipcodes:
- '64137'
- '64111'
- '64053'
- '64055'
- '64064'
- '64029'
- '64106'
- '64108'
- '64034'
- '64118'
- '64136'
- '64139'
- '64125'
- '64030'
- '64014'
- '64066'
- '64080'
- '64123'
- '64131'
- '64145'
- '64128'
- '64121'
- '64170'
- '64050'
- '64057'
- '64133'
- '64109'
- '64130'
- '64134'
- '64129'
- '64158'
- '64163'
- '64070'
- '64102'
- '64105'
- '64086'
- '64101'
- '64124'
- '64157'
- '64088'
- '64061'
- '64051'
- '64002'
- '64081'
- '64013'
- '64016'
- '64112'
- '64114'
- '64110'
- '64152'
- '64127'
- '64147'
- '64120'
- '64146'
- '64199'
- '64058'
- '64054'
- '64074'
- '64119'
- '64138'
- '64149'
- '64156'
- '64132'
- '64171'
- '64148'
- '64141'
- '64999'
- '64052'
- '64015'
- '64063'
- '64075'
- '64056'
- '64082'
- '64113'
- '64155'
- '64126'
- '64197'
- '64065'
- '64198'
lifeexpectancy: 77.19
avgincome: 47054
povertyrate: 13.7
costofliving:
livingwage: 14.55
foodcosts: 3246
medicalcosts: 2681
housingcosts: 8136
taxcosts: 6263
landareakm2: 1565.601892
areakm2: 1596.319707
| key | value |
|---|---|
| name | jackson county |
| state | MO |
| age | {0-4:0.0644100874666257,5-9:0.06532756955438819,10-14:0.06595060390235714,15-19:0.05967616438434107,20-24:0.059725950234064615,25-29:0.08192474939936928,30-34:0.07523353119652466,35-39:0.06868029092005673,40-44:0.05831060964906666,45-49:0.058805623240603636,50-54:0.05858087569042305,55-59:0.0674783182624454,60-64:0.06208437705811146,65-69:0.05099777955110233,70-74:0.03891546504962227,75-79:0.026437708656052324,80-84:0.01748905778145719,85+:0.01997123800338828} |
| male | 339932 |
| female | 363079 |
| health | {poorhealth:20.588989742,physicallyunhealthydays:4.247736361,mentallyunhealthydays:4.8111015035,lowbirthweightpercent:9.1518749808,smokerspercent:20.957241772,obesitypercent:31.5,foodenvindex:7.5,physicallyinactivepercent:23.2,excessivedrinkingpercent:18.940103365,alcoholimpaireddrivingdeaths:152,teenbirthrate:31.109351559,uninsured:12.486314662,withannualmammogram:45,vaccinated:51,childreninpoverty:19.6,80thpercentileincome:108296,20thpercentileincome:23275,childreninsingleparenthouseholds:33.224850811,violentcrimerate:941.43198334,averagedailypm25:9.1,severehousingproblems:15.347550638,drivealonetowork:83.470246386,longcommutedrivesalone:33.7} |
| longitude | -94.34749665503394 |
| latitude | 39.016701918102484 |
| education | {lessthanhighschool:9.4,highschool:28.3,somecollege:30.7,bachelors:31.6} |
| zipcodes | [64137,64111,64053,64055,64064,64029,64106,64108,64034,64118,64136,64139,64125,64030,64014,64066,64080,64123,64131,64145,64128,64121,64170,64050,64057,64133,64109,64130,64134,64129,64158,64163,64070,64102,64105,64086,64101,64124,64157,64088,64061,64051,64002,64081,64013,64016,64112,64114,64110,64152,64127,64147,64120,64146,64199,64058,64054,64074,64119,64138,64149,64156,64132,64171,64148,64141,64999,64052,64015,64063,64075,64056,64082,64113,64155,64126,64197,64065,64198] |
| lifeexpectancy | 77.19 |
| avgincome | 47054 |
| povertyrate | 13.7 |
| costofliving | {livingwage:14.55,foodcosts:3246,medicalcosts:2681,housingcosts:8136,taxcosts:6263} |
| landareakm2 | 1565.601892 |
| areakm2 | 1596.319707 |
Response Structure
All API responses follow a consistent structure with the following fields:
| Field | Type | Description | Example |
|---|---|---|---|
status | string | Indicates whether the request was successful ("ok") or failed ("error") | ok |
error | string | null | Contains error message if status is "error", otherwise null | null |
data | object | null | Contains the API response data if successful, otherwise null | {...} |
Learn more about response formats →
Response Data Fields
When the request is successful, the data object contains the following fields:
| Field | Type | Sample Value | Description |
|---|---|---|---|
name | string | County name in lowercase format | |
state | string | Two-letter state code where county is located | |
agePremium | object | Age distribution percentages by age groups | |
â”” 0-4 | number | Percentage of population aged 0-4 years | |
â”” 5-9 | number | Percentage of population aged 5-9 years | |
â”” 10-14 | number | Percentage of population aged 10-14 years | |
â”” 15-19 | number | Percentage of population aged 15-19 years | |
â”” 20-24 | number | Percentage of population aged 20-24 years | |
â”” 25-29 | number | Percentage of population aged 25-29 years | |
â”” 30-34 | number | Percentage of population aged 30-34 years | |
â”” 35-39 | number | Percentage of population aged 35-39 years | |
â”” 40-44 | number | Percentage of population aged 40-44 years | |
â”” 45-49 | number | Percentage of population aged 45-49 years | |
â”” 50-54 | number | Percentage of population aged 50-54 years | |
â”” 55-59 | number | Percentage of population aged 55-59 years | |
â”” 60-64 | number | Percentage of population aged 60-64 years | |
â”” 65-69 | number | Percentage of population aged 65-69 years | |
â”” 70-74 | number | Percentage of population aged 70-74 years | |
â”” 75-79 | number | Percentage of population aged 75-79 years | |
â”” 80-84 | number | Percentage of population aged 80-84 years |
Headers
Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →
GraphQL AccessALPHA
Access County Data Lookup through GraphQL to combine it with other API calls in a single request. Query only the county data lookup data you need with precise field selection, and orchestrate complex data fetching workflows.
Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.
POST https://api.apiverve.com/v1/graphqlquery {
countydata(
input: {
state: "MO"
county: "Jackson"
}
) {
name
state
age {
0_4
5_9
10_14
15_19
20_24
25_29
30_34
35_39
40_44
45_49
50_54
55_59
60_64
65_69
70_74
75_79
80_84
85+
}
male
female
health {
poorhealth
physicallyunhealthydays
mentallyunhealthydays
lowbirthweightpercent
smokerspercent
obesitypercent
foodenvindex
physicallyinactivepercent
excessivedrinkingpercent
alcoholimpaireddrivingdeaths
teenbirthrate
uninsured
withannualmammogram
vaccinated
childreninpoverty
80thpercentileincome
20thpercentileincome
childreninsingleparenthouseholds
violentcrimerate
averagedailypm25
severehousingproblems
drivealonetowork
longcommutedrivesalone
}
longitude
latitude
education {
lessthanhighschool
highschool
somecollege
bachelors
}
zipcodes
lifeexpectancy
avgincome
povertyrate
costofliving {
livingwage
foodcosts
medicalcosts
housingcosts
taxcosts
}
landareakm2
areakm2
}
}Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.
CORS Support
The County Data Lookup API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →
Rate Limiting
County Data Lookup requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →
Error Codes
The County Data Lookup API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →
SDKs for County Data Lookup
Official County Data Lookup packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →
No-Code Integrations
County Data Lookup works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →
Frequently Asked Questions
How do I get an API key for County Data Lookup?
How many credits does County Data Lookup cost?
Each successful County Data Lookup API call consumes credits based on plan tier. Check the pricing section above for the exact credit cost. Failed requests and errors don't consume credits, so you only pay for successful county data lookup lookups.
Can I use County Data Lookup in production?
The free plan is for testing and development only. For production use of County Data Lookup, upgrade to a paid plan (Starter, Pro, or Mega) which includes commercial use rights, no attribution requirements, and guaranteed uptime SLAs. All paid plans are production-ready.
Can I use County Data Lookup from a browser?
What happens if I exceed my County Data Lookup credit limit?
When you reach your monthly credit limit, County Data Lookup API requests will return an error until you upgrade your plan or wait for the next billing cycle. You'll receive notifications at 80% and 95% usage to give you time to upgrade if needed.








