Overview

About the Data

County Business Patterns (CBP) is an annual series that provides subnational economic data by industry. This series includes the number of establishments, employment during the week of March 12, first quarter payroll, and annual payroll. This data is useful for studying the economic activity of small areas; analyzing economic changes over time; and as a benchmark for other statistical series, surveys, and databases between economic censuses. Businesses use the data for analyzing market potential, measuring the effectiveness of sales and advertising programs, setting sales quotas, and developing budgets. Government agencies use the data for administration and planning.

ZIP Code Business Patterns data is available shortly after the release of County Business Patterns. It provides the number of establishments by employment-size classes by detailed industry in the U.S.

These two programs cover most of the country's economic activity based on establishments, with a few noted exclusions. For more information on the coverage and methodology of CBP, see How the Data are Collected. For information on businesses without paid employees, see Nonemployer Statistics. Data for 2012 were released in May 2014. For help accessing the data via hypertext tables or American FactFinder, please refer to the Data User Guide [PDF].

About Us

In December 2014, The Ewing Marion Kauffman Foundation awarded AVAIL with a grant to create an Entrepreneurial Landscape Analysis Tool that shows business climate change over time. This API is for allowing easy access to the Zip Business Patterns dataset(s) from the US census to be used for that webtool.

Geography Routes

/zipcodes/:type/:fips

Returns a list of zip codes. If no fips code is passed a list of all US zip codes is returned. :type specifies whether the fips code is for a metro area, county, or state. If :type is specified to be "metro", then all zip codes in that metro area are returned; the same applies for "county" and "state".

Copy
http://zbpa.api.availabs.org/zipcodes 
Output

{
  "data": [
    "00501",
    "01001",
    "01002",
    "01003",
    "01004",
    "01005",
    ...
    ]
}
    

/geozipcodes

Returns a topojson of either the POSTed array of zipcodes or the POSTed fips code.

Copy
http://zbpa.api.availabs.org/geozipcodes
required POST: 
zips - An array of zip codes ex {"zips": ["95014","95050"]}  
or
fips- An object with attributes of FIPS code type (metro, county, or state) and FIPS code ex {"fips":{"type": "metro", "code": "63217"}}
                 

Output:


{
  "type":"Topology",
  "transform":{
    "scale":[0.0036000360003600037,0.0016925586033320111],
    "translate":[-180,-85.60903777459777]
    },
  "objects":{
    "land":{
      "type":"MultiPolygon",
      "arcs":[
        ...   
      ],
      ...
    } 
    ...
  }
}

    

/naics/:ncode

Returns a list of naics codes related to :ncode, or all naics if no :ncode is provided.

http://zbpa.api.availabs.org/naics/:ncode 

Output:


{
  "data": [
    "----",
    "------",
    "07--",
    "0700",
    "0710",
    "0720",
    "0740",
    "0750",
    "0760",
    "0761",
    ...
  ] 
}

    

Zip Business Patterns Totals Routes

Variables Available:

  • annual_payroll: The total annual payroll, in thousands of dollars, for a zipcode.
  • q1_payroll: The total first quarter payroll, in thousands of dollars, for a zipcode.
  • employees: The total mid-March employees for a zipcode.
  • establishments: Total number of establishments for a zipcode.

/totals/:variable_name/

Returns a list of the requested variable for each of the POSTed zip codes from 1994 to 2012 or for each of the zip codes within the specified FIPS code.

Copy
http://zbpa.api.availabs.org/totals/:variable_name
required POST: 
zips - An array of zip codes ex {"zips": ["95014","95050"]}  
or
fips- An object with attributes of FIPS code type (metro, county, or state) and FIPS code ex {"fips":{"type": "metro", "code": "63217"}}
                 

Output:


{
    "data": {
        "1994": {
            "99516": 1656,
            "99517": 3078
        },
        "1995": {
            "99516": 1760,
            "99517": 3082
        },
        ...
    }
}
    

/totals/:variable_name/:year

Returns a list of the requested variable for each of the POSTed zip codes or for each of the zip codes within the specified FIPS code in the year requested (from 1994 to 2012).

Copy
http://zbpa.api.availabs.org/totals/:variable_name/:year
required POST: 
zips - An array of zip codes ex {"zips": ["95014","95050"]} 
or 
fips- An object with attributes of FIPS code type (metro, county, or state) and FIPS code ex {"fips":{"type": "metro", "code": "63217"}}
                 

Output:


{
    "data": {
        "99516": 1308,
        "99517": 1819
    }
}
  

Zip Business Patterns Details Routes

Details Key

Each zip code contains the figures of

  • total establishments,
  • number of establishments with 1-4 employees,
  • number of establishments with 5-9 employees,
  • number of establishments with 10-19 employees,
  • number of establishments with 20-49 employees,
  • number of establishments with 50-99 employees,
  • number of establishments with 100-249 employees,
  • number of establishments with 250-499 employees,
  • number of establishments with 500-999 employees, and
  • number of establishments with 1000 or more employees
in that zip code.

/details

Returns, for each of the POSTed zip codes or for each of the zip codes within the specified FIPS code, a list of the business figures for those businesses categorized under the given NAICS code in those zipcodes from 1994 to 2012.

Copy
http://zbpa.api.availabs.org/details
required POST: 
naics - An array of naics codes ex {"naics": ["72", "13"]} 
and one of the following:
zips - An array of zip codes ex {"zips": ["95014","95050"]} 
or
fips- An object with attributes of FIPS code type (metro, county, or state) and FIPS code ex {"fips":{"type": "metro", "code": "63217"}}
                 

Output:


{
    "data": {
        "1994": {
            "95014": {
                "total": "52",
                "1-4": "33",
                "5-9": "9",
                "10-19": "7",
                "20-49": "1",
                "50-99": "1",
                "100-249": "1",
                "250-499": "0",
                "500-999": "0",
                "1000+": "0"
            },
            "95050": {
                "total": "43",
                "1-4": "25",
                "5-9": "11",
                "10-19": "5",
                "20-49": "2",
                "50-99": "0",
                "100-249": "0",
                "250-499": "0",
                "500-999": "0",
                "1000+": "0"
            }
        },        ...
    }
}
    

/details/:year

Returns, for each of the POSTed zip codes or for each of the zip codes within the specified FIPS code, a list of the business figures for those businesses categorized under the given NAICS code in those zipcodes in the year requested (from 1994 to 2012).

Copy
http://zbpa.api.availabs.org/details/:year
required POST: 
naics - An array of naics codes ex {"naics": ["72", "13"]}
and one of the following:
zips - An array of zip codes ex {"zips": ["95014","95050"]} 
or
fips- An object with attributes of FIPS code type (metro, county, or state) and FIPS code ex {"fips":{"type": "metro", "code": "63217"}}
                 

Output:


{
    "data": {
        "95014": {
            "total": "134",
            "1-4": "29",
            "5-9": "24",
            "10-19": "38",
            "20-49": "30",
            "50-99": "11",
            "100-249": "2",
            "250-499": "0",
            "500-999": "0",
            "1000+": "0"
        },
        ...
    }
}