Industry Market Data

This section describes US and Local Industry Market Data access, BizMiner's Industry Market Trend Series.

Endpoint

https://api.bizminer.com/v1/bizminer/imrdata/{bznaics}/{areaId}/{zips}/{mapCenter}/{mapCenterZip}/{radius}/{apiKey}/{requestId}/{hash}

Request Type

• get - all requests to this endpoint must be get types.

Demo

https://api.bizminer.com/v1/bizminer/imrdata/238220/0/17011,17043,17055/0/0/0/77DE68DAECD823BABBB58EDB1C8E14D7106E83BB/1/27f3e379cf66f5401245a925a2f70826704af408

Parameters

All parameters are required. For market area, there are three options:

• areaId - for All US, states, metro areas, and counties.
• zips - for single or multiple zip codes.
• mapCenter/mapCenterZip/radius - for radius areas.

Default to 0 for unused parameters.

bznaics (decimal 12,6)
The BizMiner industry code. API Endpoint

areaId (int 10)
The area id, US, state, metro, or county. API Endpoint
zips (varchar 255)
One or more zip code, separated by commas. API Endpoint
mapCenter (varchar 255)
A US address for the center of a radius area. 
mapCenterZip (varchar 255)
The zip code for the center of a radius area. 
radius (int 3)
The radius in miles of the market area. 
apiKey (varchar 40)
The API key as provided by BizMiner staff. Used for authentication and billing.
requestId (varchar 16)
An optional value to track and debug client calls. Default to 0. 
hash (varchar 40)
The SHA1 hashed value of: bznaics + areaId + zips + mapCenter + mapCenterZip + radius + apiKey using the secret provided by BizMiner at the time of providing the API key. This is used to authenticate requests. If the hash does not match server-side validation, and error response will be returned. 

Successful Response Data Structure

The following is the data structure of 200 responses. For a list of unsuccessful response codes see here.

 -status (HTTP code)
 -responseID (unique code from the server for debugging)
 -reportMeta [collection] (report parameters)
    -reportType (report title)
    -timeSeries (report data time series)
    -cessationTimeSeries (time series of the cessation values)
    -bznaics (report bznaics code)
    -area (report area title)
    -industry (report industry name)
    -sector (report sector)   

 -reportData [collection]
    -mapData [collection]
        -coordinates[collection] (competitors)
            -latt
            -long
            ...
        -centerLat
        -centerLng
        -centerAddress
        -centerZip
    -updateMonth [collection] (most recent month of data)
        -year
        -industryMarketAreaOperations [collection]
            -industrySites
            -firms
            -smallBusiness
            -startups
            -branches
        -market [collection]
            -volume [collection]
                -industry
                -smallBusiness
                -startups
            -share [colletion]
                -industry
                -smallBusiness
                -startups
        -averageAnnualSales [collection]
            -averageSite
            -medianSite
            -smallBusiness
            -startups
        -marketPenetration [collection]
            -marketSalesPerPerson
            -USSalesPerPerson
            -marketSalesPerHousehold
            -USSalesPerHousehold
        -industryEmployment [collection]
            -industryTotal
            -averageOperation
            -averageSmallBusiness
            -averageStartups
        -productivity [collecction]
            -salesPerEmployee [collection]
                -US
                -marketArea
            -averageAnnualWage [collection]
                -US
                -marketArea
            -rentPerEmployee [collection]
                -US
                -marketArea
        -startupPerformance [collection]
            -population
            -averageSales
            -marketVolume
            -marketShare
    -year3 [collection] (most recent year of data)
        -year
        -industryMarketAreaOperations [collection]
            -industrySites
            -firms
            -smallBusiness
            -startups
            -branches
        -market [collection]
            -volume [collection]
                -industry
                -smallBusiness
                -startups
            -share [colletion]
                -industry
                -smallBusiness
                -startups
        -averageAnnualSales [collection]
            -averageSite
            -medianSite
            -smallBusiness
            -startups
        -marketPenetration [collection]
            -marketSalesPerPerson
            -USSalesPerPerson
            -marketSalesPerHousehold
            -USSalesPerHousehold
        -industryEmployment [collection]
            -industryTotal
            -averageOperation
            -averageSmallBusiness
            -averageStartups
        -productivity [collecction]
            -salesPerEmployee [collection]
                -US
                -marketArea
            -averageAnnualWage [collection]
                -US
                -marketArea
            -rentPerEmployee [collection]
                -US
                -marketArea
        -salesEmploymentClasses [collection]
            -marketVolumeByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
            -percentMarketVolumeByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
            -averageSalesByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
        -productivity [collecction]
            -salesPerEmployee [collection]
                -US
                -marketArea
            -averageAnnualWage [collection]
                -US
                -marketArea
            -rentPerEmployee [collection]
                -US
                -marketArea
        -startupPerformance [collection]
            -population
            -averageSales
            -marketVolume
            -marketShare
        -cessationRates [collection]
            -establishments
            -firms
            -smallBusiness
            -startups
            -branches
        -ownership [collection]
            -industryBranchConcentration [collection]
                -localIndustry
                -USIndustry
    -year2 [collection] (second recent year of data)
        -year
        -industryMarketAreaOperations [collection]
            -industrySites
            -firms
            -smallBusiness
            -startups
            -branches
        -market [collection]
            -volume [collection]
                -industry
                -smallBusiness
                -startups
            -share [colletion]
                -industry
                -smallBusiness
                -startups
        -averageAnnualSales [collection]
            -averageSite
            -medianSite
            -smallBusiness
            -startups
        -marketPenetration [collection]
            -marketSalesPerPerson
            -USSalesPerPerson
            -marketSalesPerHousehold
            -USSalesPerHousehold
        -industryEmployment [collection]
            -industryTotal
            -averageOperation
            -averageSmallBusiness
            -averageStartups
        -productivity [collecction]
            -salesPerEmployee [collection]
                -US
                -marketArea
            -averageAnnualWage [collection]
                -US
                -marketArea
            -rentPerEmployee [collection]
                -US
                -marketArea
        -salesEmploymentClasses [collection]
            -marketVolumeByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
            -percentMarketVolumeByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
            -averageSalesByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
        -productivity [collecction]
            -salesPerEmployee [collection]
                -US
                -marketArea
            -averageAnnualWage [collection]
                -US
                -marketArea
            -rentPerEmployee [collection]
                -US
                -marketArea
        -startupPerformance [collection]
            -population
            -averageSales
            -marketVolume
            -marketShare
        -ownership [collection]
            -industryBranchConcentration [collection]
                -localIndustry
                -USIndustry
    -year1 [collection] (third recent year of data)
        -year
        -industryMarketAreaOperations [collection]
            -industrySites
            -firms
            -smallBusiness
            -startups
            -branches
        -market [collection]
            -volume [collection]
                -industry
                -smallBusiness
                -startups
            -share [colletion]
                -industry
                -smallBusiness
                -startups
        -averageAnnualSales [collection]
            -averageSite
            -medianSite
            -smallBusiness
            -startups
        -marketPenetration [collection]
            -marketSalesPerPerson
            -USSalesPerPerson
            -marketSalesPerHousehold
            -USSalesPerHousehold
        -industryEmployment [collection]
            -industryTotal
            -averageOperation
            -averageSmallBusiness
            -averageStartups
        -productivity [collecction]
            -salesPerEmployee [collection]
                -US
                -marketArea
            -averageAnnualWage [collection]
                -US
                -marketArea
            -rentPerEmployee [collection]
                -US
                -marketArea
        -salesEmploymentClasses [collection]
            -marketVolumeByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
            -percentMarketVolumeByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
            -averageSalesByClass [collection]
                -small1to24
                -medium25to99
                -large100Plus
                -unknown
                -total
        -productivity [collecction]
            -salesPerEmployee [collection]
                -US
                -marketArea
            -averageAnnualWage [collection]
                -US
                -marketArea
            -rentPerEmployee [collection]
                -US
                -marketArea
        -startupPerformance [collection]
            -population
            -averageSales
            -marketVolume
            -marketShare
        -ownership [collection]
            -industryBranchConcentration [collection]
                -localIndustry
                -USIndustry
    -demographics [collection]
        -totalPopulation [collection]
            -totalPopulation
            -totalPopulationPercent
            -totalMale
            -totalMalePercent
            -totalFemale
            -totalFemalePercent
        -age [collection]
            -5to9Years
            -5to9YearsPercent
            -10to14Years
            -10to14YearsPercent
            -15to19Years
            -15to19YearsPercent
            -20to24Years
            -20to24YearsPercent
            -25to34Years
            -25to34YearsPercent
            -35to44Years
            -35to44YearsPercent
            -45to54Years
            -45to54YearsPercent
            -55to59Years
            -55to59YearsPercent
            -60to64Years
            -60to64YearsPercent
            -65to74Years
            -65to74YearsPercent
            -85PlusYears
            -85PlusYearsPercent
            -medianAge
        -raceEthnicity [collection]
            -white
            -whitePercent
            -hispanic
            -hispanicPercent
            -africanAmerican
            -africanAmericanPercent
            -asian
            -asianPercent
            -asianIndian
            -asianIndianPercent
            -2orMoreRaces
            -2orMoreRacesPercent
        -employment [collection]
            -population16PlusYears
            -population16PlusYearsPercent
            -laborForce
            -laborForcePercent
            -meanCommuteMinutes
            -civilianLaborForce
            -civilianLaborForcePercent
            -civilianEmployment
            -civilianEmploymentPercent
            -unemployed
            -unemployedPercent
            -workAtHome
            -workAtHomePercent
        -income [collection]
            -totalHouseholds
            -totalHouseholdsPercent
            -below10kIncome
            -below10kIncomePercent
            -10kto14_9kIncome
            -10kto14_9kIncomePercent
            -15kto24_9kIncome
            -15kto24_9kIncomePercent
            -25kto34_9kIncome
            -25kto34_9kIncomePercent
            -34kto49_9kIncome
            -34kto49_9kIncomePercent
            -50kto74_9kIncome
            -50kto74_9kIncomePercent
            -75kto99_9kIncome
            -75kto99_9kIncomePercent
            -100kto149_9kIncome
            -100kto149_9kIncomePercent
            -150kto199_9kIncome
            -150kto199_9kIncomePercent
            -200kIncome
            -200kIncomePercent
            -medianHHIncome
            -meanHHIncome
            -perCapitaIncome
        -education
            -population25PlusYears
            -population25PlusYearsPercent
            -highSchoolGraduate
            -highSchoolGraduatePercent
            -someCollegeNoDegree
            -someCollegeNoDegreePercent
            -associatesDegree
            -associatesDegreePercent
            -bachelorsDegree
            -bachelorsDegreePercent
            -graduateProfessionalDegree
            -graduateProfessionalDegreePercent
            -highSchoolGraduateorHigher
            -highSchoolGraduateorHigherPercent
            -bachelorsDegreeorHigher
            -bachelorsDegreeorHigherPercent
        -housing
            -totalHousingUnits
            -totalHousingUnitsPercent
            -occupiedHousingUnits
            -occupiedHousingUnitsPercent
            -typeofHousing [collection]
                -1UnitDetachedHousingStructures
                -1UnitDetachedHousingStructuresPercent
                -1UnitAttachedHousingStructures
                -1UnitAttachedHousingStructuresPercent
                -2UnitHousingStructures
                -2UnitHousingStructuresPercent
                -3to4UnitHousingStructures
                -3to4UnitHousingStructuresPercent
                -5to9UnitHousingStructures
                -5to9UnitHousingStructuresPercent
                -10to19UnitHousingStructures
                -10to19UnitHousingStructuresPercent
                -20PlusUnitHousingStructures
                -20PlusUnitHousingStructuresPercent
                -mobileHomeHousingUnits
                -mobileHomeHousingUnitsPercent
                -boatRVVanHousingUnits
                -boatRVVanHousingUnitsPercent
            -ageofHousing [collection]
                -housingBuilt2010orLater
                -housingBuilt2010orLaterPercent
                -housingBuilt2000to2009
                -housingBuilt2000to2009Percent
                -housingBuilt1990to1999
                -housingBuilt1990to1999Percent
                -housingBuilt1980to1989
                -housingBuilt1980to1989Percent
                -housingBuilt1970to1979
                -housingBuilt1970to1979Percent
                -housingBuilt1960to1969
                -housingBuilt1960to1969Percent
                -housingBuilt1950to1959
                -housingBuilt1950to1959Percent
                -housingBuilt1940to1949
                -housingBuilt1940to1949Percent
                -housingBuilt1939orBefore
                -housingBuilt1939orBeforePercent
            -occupantsPerUnit [collection]
                -unitsWithLess1OccupantPerRoom
                -unitsWithLess1OccupantPerRoomPercent
                -unitsWith1_1to1_5OccupantsPerRoom
                -unitsWith1_1to1_5OccupantsPerRoomPercent
                -unitsWith1_51toPlusOccupantsPerRoom
                -unitsWith1_51toPlusOccupantsPerRoomPercent
            -occupantsUnitsValue [collection]
                -medianValueofOwnerOccupiedUnits
                -ownerOccupiedUnitsValueLess50k
                -ownerOccupiedUnitsValueLess50kPercent
                -ownerOccupiedUnitsValue50kto99_9k
                -ownerOccupiedUnitsValue50kto99_9kPercent
                -ownerOccupiedUnitsValue100kto149_9k
                -ownerOccupiedUnitsValue100kto149_9kPercent
                -ownerOccupiedUnitsValue150kto199_9k
                -ownerOccupiedUnitsValue150kto199_9kPercent
                -ownerOccupiedUnitsValue200kto299_9k
                -ownerOccupiedUnitsValue200kto299_9kPercent
                -ownerOccupiedUnitsValue300kto499_9k
                -ownerOccupiedUnitsValue300kto499_9kPercent
                -ownerOccupiedUnitsValue500kto999_9k
                -ownerOccupiedUnitsValue500kto999_9kPercent
                -ownerOccupiedUnitsValueMoreThan1Million
                -ownerOccupiedUnitsValueMoreThan1MillionPercent
                -ownerOccupiedUnitsWithMortgage
                -ownerOccupiedUnitsWithMortgagePercent
                -ownerOccupiedUnitsWithoutMortgage
                -ownerOccupiedUnitsWithoutMortgagePercent
            -occupantsUnitsRent [collection]
                -occupiedUnitsPayingRent
                -occupiedUnitsPayingRentPercent
                -medianRentPaid
                -occupiedUnitsPayingLessThan500Rent
                -occupiedUnitsPayingLessThan500RentPercent
                -occupiedUnitsPaying500to999Rent
                -occupiedUnitsPaying500to999RentPercent
                -occupiedUnitsPaying1000to1499Rent
                -occupiedUnitsPaying1000to1499RentPercent
                -occupiedUnitsPaying1500to1999Rent
                -occupiedUnitsPaying1500to1999RentPercent
                -occupiedUnitsPaying2000to2499Rent
                -occupiedUnitsPaying2000to2499RentPercent
                -occupiedUnitsPaying2500to3000Rent
                -occupiedUnitsPaying2500to3000RentPercent
                -occupiedUnitsPaying3000orMoreRent
                -occupiedUnitsPaying3000orMoreRentPercent
                -rentPaidLessThan15PercentofIncomeHouseholds
                -rentPaidLessThan15PercentofIncomeHouseholdsPercent
                -rentPaid15Percentto19_9PercentofIncomeHouseholds
                -rentPaid15Percentto19_9PercentofIncomeHouseholdsPercent
                -rentPaid20Percentto24_9PercentofIncomeHouseholds
                -rentPaid20Percentto24_9PercentofIncomeHouseholdsPercent
                -rentPaid25Percentto29_9PercentofIncomeHouseholds
                -rentPaid25Percentto29_9PercentofIncomeHouseholdsPercent
                -rentPaid30Percentto34_9PercentofIncomeHouseholds
                -rentPaid30Percentto34_9PercentofIncomeHouseholdsPercent
                -rentPaid35PercenttoPlusofIncomeHouseholds
                -rentPaid35PercenttoPlusofIncomeHouseholdsPercent