Kadrin Docs
Kadrin gives you facts about any place in the US, for exactly the area you care about: who lives there, what they earn, their homes, the jobs there and the businesses nearby.
Send a place in whatever form you have it: a point, a radius (everywhere within a set distance), a drive-time area (everywhere you can reach by car in a set number of minutes), your own outline, or an official area such as a county. Kadrin Batch also takes addresses. You get the numbers for that place, each with its source, the years it describes and, for survey estimates, its margin of error (how far the true number could reasonably be from our estimate).
Three ways in
| What it's for | Start here | |
|---|---|---|
| Kadrin Batch | Spreadsheets of places, with no code: upload a file of addresses and download it with numbers added. | Batch quickstart |
| The API | Your own code and apps. | API quickstart |
| Kadrin for AI | AI assistants, which can ask Kadrin for you while you talk. | AI quickstart |
All three use one account and one balance of credits.
What it costs
You pay in credits. One credit covers one group of related measures, such as household income, for one place. Drawing a drive-time area costs 2 credits more. Browsing the measures, checking a cost first, and anything that fails are free.
Test keys are free too. They give made-up numbers, so you can build and try things before spending credits.
During the beta, each account starts with 50,000 credits and gets 50 free credits a day, and nothing is charged in money.
Ready-made reports
Two presets ask for a useful set of measures by name:
- Site report: who lives and works within a short drive of each place, what they earn, and the businesses nearby. For choosing and comparing sites.
- Submarket report: how the area is growing, its jobs and workers, and what people earn and pay for housing. For sizing up a real estate submarket.
Or choose from every measure yourself.
Where the numbers come from
- People, income and homes: U.S. Census Bureau, American Community Survey (a yearly survey of households), 2020–2024.
- Jobs: U.S. Census Bureau, LEHD Origin-Destination Employment Statistics (LODES), counted where the jobs are.
- Businesses: Overture Maps Foundation, Places.
- Where people live inside each area: U.S. Census Bureau, 2020 Census.
- Drive-time areas: roads from OpenStreetMap. Wherever you show one, credit "© OpenStreetMap contributors".
When your shape covers only part of an official area, we estimate its share by looking at where people actually live inside that area. How we estimate any shape explains it.
Every answer also names its release: a frozen snapshot of our data, so the same request always gives the same answer. GET /releases lists them, with what changed in each.