{ "openapi": "3.1.0", "info": { "title": "Business Patterns API", "version": "1.0.0", "description": "Establishments, employment and payroll for every US county, state and ZIP by NAICS industry, Census 2023.\n\nThe business density of every place in America, straight from the US Census Bureau: establishments, employment, annual payroll and employer-size distributions from County Business Patterns and ZIP Code Business Patterns 2023, the latest release. Coverage is complete and consistent — 3,192 counties, all 50 states plus DC, 34,953 ZIP codes and roughly 2,000 NAICS-2022 industries from 2-digit sectors down to 6-digit detail (1.1 million county-industry cells, 2.9 million ZIP-industry cells). Ask how many full-service restaurants operate in the US (258,626), which county leads (Los Angeles, 8,214), which ZIP codes concentrate finance firms (the Chicago Loop and Midtown Manhattan), or what the industry mix of ZIP 10001 looks like. NAICS codes are accepted bare or CBP-formatted and every response carries plain-English industry titles; Census noise flags are surfaced honestly (withheld values are null, never fake zeros). Built for market sizing, site selection, lead-gen targeting, credit and insurance modeling, and economic research. Public-domain source data, self-hosted — no third-party calls at request time.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/business-patterns.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/business-patterns" }, "servers": [ { "url": "https://api-business-patterns.dataandapis.com" } ], "tags": [ { "name": "Business", "description": "Business Patterns API belongs to the Business category of the Data and APIs catalog." } ], "paths": { "/v1/counties/{fips}": { "get": { "operationId": "countyProfile", "summary": "County Profile", "description": "County Profile endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/county-profile" }, "parameters": [ { "name": "fips", "in": "path", "required": true, "schema": { "type": "string" }, "example": "06037" }, { "name": "level", "in": "query", "required": false, "schema": { "type": "string" }, "example": "2" }, { "name": "naics", "in": "query", "required": false, "schema": { "type": "string" }, "example": "72" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "county": { "fips": "06037", "name": "Los Angeles County", "state": "CA", "state_name": "California" }, "naics_level": 2, "count": 4, "results": [ { "industry": { "naics": "54", "cbp_code": "54----", "level": 2, "title": "Professional, scientific & technical services" }, "establishments": 43257, "employees": 320516, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 8908771, "annual_payroll_thousands": 36670078, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 33492, "5-9": 4605, "10-19": 2559, "20-49": 1640, "50-99": 521, "100-249": 298, "250-499": 96, "500-999": 33, "1000+": 13 } }, { "industry": { "naics": "62", "cbp_code": "62----", "level": 2, "title": "Health care and social assistance" }, "establishments": 39246, "employees": 642665, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 10741744, "annual_payroll_thousands": 44788653, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 23178, "5-9": 7057, "10-19": 4520, "20-49": 2726, "50-99": 900, "100-249": 611, "250-499": 129, "500-999": 52, "1000+": 73 } }, { "industry": { "naics": "44", "cbp_code": "44----", "level": 2, "title": "Retail trade" }, "establishments": 28998, "employees": 419890, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 4653641, "annual_payroll_thousands": 18941036, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 14777, "5-9": 5909, "10-19": 3896, "20-49": 2565, "50-99": 1083, "100-249": 639, "250-499": 110, "500-999": 17, "1000+": null } }, { "industry": { "naics": "72", "cbp_code": "72----", "level": 2, "title": "Accommodation & food services" }, "establishments": 25110, "employees": 459745, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 3571698, "annual_payroll_thousands": 14865803, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 7461, "5-9": 4554, "10-19": 5949, "20-49": 5381, "50-99": 1334, "100-249": 363, "250-499": 51, "500-999": 13, "1000+": 4 } } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "reference_year": 2023, "count": 3, "sources": [ { "slug": "zbp", "name": "ZIP Code Business Patterns 2023", "publisher": "US Census Bureau", "licence": "US Government work - public domain", "source_url": "https://www.census.gov/programs-surveys/cbp.html", "file_url": "https://www2.census.gov/programs-surveys/cbp/datasets/2023/zbp23detail.zip", "cadence": "annual (spring release)", "record_count": 2938433, "retrieved_at": "2026-09-05" }, { "slug": "cbp", "name": "County Business Patterns 2023", "publisher": "US Census Bureau", "licence": "US Government work - public domain", "source_url": "https://www.census.gov/programs-surveys/cbp.html", "file_url": "https://www2.census.gov/programs-surveys/cbp/datasets/2023/cbp23co.zip", "cadence": "annual (spring release)", "record_count": 1100961, "retrieved_at": "2026-09-05" }, { "slug": "bls-naics-titles", "name": "BLS QCEW industry titles (NAICS)", "publisher": "US Bureau of Labor Statistics", "licence": "US Government work - public domain", "source_url": "https://www.bls.gov/cew/classifications/industry/", "file_url": "https://data.bls.gov/cew/doc/titles/industry/industry_titles.csv", "cadence": "static", "record_count": 2003, "retrieved_at": "2026-09-05" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/national": { "get": { "operationId": "nationalStatistics", "summary": "National Statistics", "description": "National Statistics endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/national-statistics" }, "parameters": [ { "name": "level", "in": "query", "required": false, "schema": { "type": "string" }, "example": "2" }, { "name": "naics", "in": "query", "required": false, "schema": { "type": "string" }, "example": "722511" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "scope": "United States", "naics_level": 2, "count": 4, "results": [ { "industry": { "naics": "44", "cbp_code": "44----", "level": 2, "title": "Retail trade" }, "establishments": 1043373, "employees": 16046207, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 149614987, "annual_payroll_thousands": 605675581, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 457825, "5-9": 248198, "10-19": 171604, "20-49": 104761, "50-99": 32165, "100-249": 22574, "250-499": 5684, "500-999": 418, "1000+": 144 } }, { "industry": { "naics": "62", "cbp_code": "62----", "level": 2, "title": "Health care and social assistance" }, "establishments": 1003398, "employees": 22063238, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 336131355, "annual_payroll_thousands": 1394716191, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 472802, "5-9": 202848, "10-19": 157484, "20-49": 103599, "50-99": 35898, "100-249": 21296, "250-499": 5055, "500-999": 2112, "1000+": 2304 } }, { "industry": { "naics": "54", "cbp_code": "54----", "level": 2, "title": "Professional, scientific & technical services" }, "establishments": 989182, "employees": 10401442, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 279772224, "annual_payroll_thousands": 1114419103, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 706067, "5-9": 124228, "10-19": 76923, "20-49": 50645, "50-99": 16599, "100-249": 9869, "250-499": 3022, "500-999": 1149, "1000+": 680 } }, { "industry": { "naics": "23", "cbp_code": "23----", "level": 2, "title": "Construction" }, "establishments": 814557, "employees": 7659459, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 134815706, "annual_payroll_thousands": 586559516, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 536259, "5-9": 127972, "10-19": 75854, "20-49": 49046, "50-99": 15448, "100-249": 7616, "250-499": 1640, "500-999": 525, "1000+": 197 } } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/counties": { "get": { "operationId": "searchCounties", "summary": "Search Counties", "description": "Search Counties endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/search-counties" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "25" }, { "name": "min_establishments", "in": "query", "required": false, "schema": { "type": "string" }, "example": "100" }, { "name": "naics", "in": "query", "required": false, "schema": { "type": "string" }, "example": "722511" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Los Angeles" }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string" }, "example": "CA" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "industry": { "naics": "722511", "cbp_code": "722511", "level": 6, "title": "Full-service restaurants" }, "total": 1, "page": 1, "limit": 25, "count": 1, "results": [ { "fips": "06037", "county": "Los Angeles County", "state": "CA", "state_name": "California", "establishments": 8214, "employees": 169457, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 1420285, "annual_payroll_thousands": 5879167, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 2174, "5-9": 1442, "10-19": 1839, "20-49": 1913, "50-99": 665, "100-249": 176, "250-499": 5, "500-999": null, "1000+": null } } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/industries": { "get": { "operationId": "searchIndustries", "summary": "Search Industries", "description": "Search Industries endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/search-industries" }, "parameters": [ { "name": "level", "in": "query", "required": false, "schema": { "type": "string" }, "example": "6" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "25" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "restaurants" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 2, "industries": [ { "naics": "722513", "cbp_code": "722513", "level": 6, "title": "Limited-service restaurants", "us_establishments": 270088, "us_employees": 4965080, "us_annual_payroll_thousands": 103557315 }, { "naics": "722511", "cbp_code": "722511", "level": 6, "title": "Full-service restaurants", "us_establishments": 258626, "us_employees": 5387020, "us_annual_payroll_thousands": 150931656 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/states/{state}": { "get": { "operationId": "stateProfile", "summary": "State Profile", "description": "State Profile endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/state-profile" }, "parameters": [ { "name": "state", "in": "path", "required": true, "schema": { "type": "string" }, "example": "CA" }, { "name": "level", "in": "query", "required": false, "schema": { "type": "string" }, "example": "2" }, { "name": "naics", "in": "query", "required": false, "schema": { "type": "string" }, "example": "54" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "state": "CA", "naics_level": 2, "count": 4, "results": [ { "industry": { "naics": "54", "cbp_code": "54----", "level": 2, "title": "Professional, scientific & technical services" }, "establishments": 143863, "employees": 1430821, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 46952989, "annual_payroll_thousands": 186989374, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 105633, "5-9": 17112, "10-19": 10276, "20-49": 6656, "50-99": 2252, "100-249": 1272, "250-499": 416, "500-999": 151, "1000+": 95 } }, { "industry": { "naics": "62", "cbp_code": "62----", "level": 2, "title": "Health care and social assistance" }, "establishments": 132345, "employees": 2347305, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 42343604, "annual_payroll_thousands": 177094574, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 71935, "5-9": 26282, "10-19": 17260, "20-49": 10334, "50-99": 3459, "100-249": 2109, "250-499": 489, "500-999": 206, "1000+": 271 } }, { "industry": { "naics": "44", "cbp_code": "44----", "level": 2, "title": "Retail trade" }, "establishments": 106675, "employees": 1702044, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 18326023, "annual_payroll_thousands": 74363587, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 48647, "5-9": 23124, "10-19": 16770, "20-49": 10900, "50-99": 4296, "100-249": 2408, "250-499": 471, "500-999": 46, "1000+": 13 } }, { "industry": { "naics": "72", "cbp_code": "72----", "level": 2, "title": "Accommodation & food services" }, "establishments": 95952, "employees": 1788988, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 13717494, "annual_payroll_thousands": 56985806, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 26579, "5-9": 17835, "10-19": 23420, "20-49": 21842, "50-99": 4740, "100-249": 1280, "250-499": 173, "500-999": 52, "1000+": 31 } } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/states": { "get": { "operationId": "stateRankings", "summary": "State Rankings", "description": "State Rankings endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/state-rankings" }, "parameters": [ { "name": "naics", "in": "query", "required": false, "schema": { "type": "string" }, "example": "722511" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "industry": { "naics": "722511", "cbp_code": "722511", "level": 6, "title": "Full-service restaurants" }, "count": 4, "results": [ { "state": "CA", "establishments": 31333, "employees": 628541, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 5014718, "annual_payroll_thousands": 20805027, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 7741, "5-9": 5777, "10-19": 7437, "20-49": 7384, "50-99": 2401, "100-249": 577, "250-499": 16, "500-999": null, "1000+": null } }, { "state": "TX", "establishments": 20819, "employees": 493197, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 3137557, "annual_payroll_thousands": 12850936, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 5613, "5-9": 3370, "10-19": 3884, "20-49": 5050, "50-99": 2231, "100-249": 656, "250-499": 13, "500-999": null, "1000+": null } }, { "state": "NY", "establishments": 19661, "employees": 321790, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 2622765, "annual_payroll_thousands": 11327130, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 6884, "5-9": 3757, "10-19": 3844, "20-49": 3806, "50-99": 1061, "100-249": 296, "250-499": 11, "500-999": null, "1000+": null } }, { "state": "FL", "establishments": 18200, "employees": 444025, "employees_note": { "flag": "G", "meaning": "low noise (<2%)" }, "q1_payroll_thousands": 3350865, "annual_payroll_thousands": 12940712, "annual_payroll_note": { "flag": "G", "meaning": "low noise (<2%)" }, "establishments_by_employee_size": { "1-4": 4968, "5-9": 2723, "10-19": 3177, "20-49": 4519, "50-99": 2246, "100-249": 550, "250-499": 15, "500-999": null, "1000+": null } } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/zips/{zip}": { "get": { "operationId": "zipBusinessProfile", "summary": "ZIP Business Profile", "description": "ZIP Business Profile endpoint of the Business Patterns API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/business-patterns/zip-business-profile" }, "parameters": [ { "name": "zip", "in": "path", "required": true, "schema": { "type": "string" }, "example": "10001" }, { "name": "level", "in": "query", "required": false, "schema": { "type": "string" }, "example": "2" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "25" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "zip": "10001", "city": "New York", "state": "NY", "county": "New York", "establishments": 6325, "employees": 173194, "q1_payroll_thousands": 6695030, "annual_payroll_thousands": 21557555, "naics_level": 2, "industries": [ { "industry": { "naics": "54", "cbp_code": "54----", "level": 2, "title": "Professional, scientific & technical services" }, "establishments": 1224, "establishments_by_employee_size": { "1-4": 742, "5-9": 203, "10-19": 121, "20-49": 69, "50-99": 43, "100-249": 25, "250-499": 12, "500-999": 5, "1000+": 4 } }, { "industry": { "naics": "42", "cbp_code": "42----", "level": 2, "title": "Wholesale trade" }, "establishments": 737, "establishments_by_employee_size": { "1-4": 458, "5-9": 140, "10-19": 70, "20-49": 32, "50-99": 14, "100-249": 18, "250-499": 4, "500-999": null, "1000+": null } }, { "industry": { "naics": "44", "cbp_code": "44----", "level": 2, "title": "Retail trade" }, "establishments": 561, "establishments_by_employee_size": { "1-4": 320, "5-9": 102, "10-19": 65, "20-49": 43, "50-99": 15, "100-249": 9, "250-499": 4, "500-999": null, "1000+": null } }, { "industry": { "naics": "72", "cbp_code": "72----", "level": 2, "title": "Accommodation & food services" }, "establishments": 553, "establishments_by_employee_size": { "1-4": 139, "5-9": 100, "10-19": 112, "20-49": 130, "50-99": 44, "100-249": 22, "250-499": 5, "500-999": null, "1000+": null } } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }