Search by task, endpoint, field, or error.
Industry API
Find an industry by code or business activity.
Look up a US NAICS 2022 industry code or search by business activity. Core identifies the industry and its place in the hierarchy. Paid deep adds the official definition, child categories and exclusions. Each lookup or search uses one pooled request on every plan.
Look up a code
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.industry("541511");
console.log(result);Run on your server with a secret key. Calling from a browser or app?
{
"naics": "541511",
"name": "Custom Computer Programming Services",
"level": 6,
"parent": "54151",
"parent_name": "Computer Systems Design and Related Services",
"country": "US",
"year": 2022
}Response fields
- naicsstring
- Canonical NAICS code as a string. Combined sectors use 31-33, 44-45, or 48-49
- namestring
- Official industry name
- levelinteger
- Hierarchy level from 2 (sector) to 6 (national industry)
- parentstring or null
- Immediate parent code, or null for a sector
- parent_namestring or null
- Immediate parent name, or null for a sector
- countrystring
- Classification country. US
- yearinteger
- Classification revision. 2022
- matchobject
- Search results only. The winning field (name, term, or naics), its text, and spelling corrections as from/to pairs. Corrections is empty for ordinary matches
Pass a 2-6 digit code, or a combined sector such as 31-33. Sector aliases 31, 32, and 33 return 31-33. The same rule applies to 44-45 and 48-49. Malformed codes return 400 and unknown codes return 404.
Run this Deep example with a paid-plan key. Deep is included in the pooled request, with no separate lookup charge.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.industry("31-33", { deep: true });
console.log(result);Run on your server with a secret key. Calling from a browser or app?
{
"naics": "31-33",
"name": "Manufacturing",
"level": 2,
"parent": null,
"parent_name": null,
"country": "US",
"year": 2022,
"deep": {
"description": "The Manufacturing sector comprises establishments engaged in the mechanical, physical, or chemical transformation of materials, substances, or components into new products. The assembling of component parts of manufactured products is considered manufacturing, except in cases where the activity is appropriately classified in Sector 23, Construction.\n\nEstablishments in the Manufacturing sector are often described as plants, factories, or mills and characteristically use power-driven machines and material handling equipment. However, establishments that transform materials or substances into new products by hand or in the worker's home and those engaged in selling to the general public products made on the same premises from which they are sold, such as bakeries, candy stores, and custom tailors, may also be included in this sector. Manufacturing establishments may process materials or may contract with other establishments to process their materials for them. Both types of establishments are included in manufacturing. Selected industries in the Manufacturing sector are comprised solely of establishments that process materials for other establishments on a contract or fee basis. Beyond these dedicated contract manufacturing industries, establishments that process materials for other establishments are generally classified in the Manufacturing industry of the processed materials.\n\nThe materials, substances, or components transformed by manufacturing establishments are raw materials that are products of agriculture, forestry, fishing, mining, or quarrying as well as products of other manufacturing establishments. The materials used may be purchased directly from producers, obtained through customary trade channels, or secured without recourse to the market by transferring the product from one establishment to another, under the same ownership.\n\nThe new product of a manufacturing establishment may be finished in the sense that it is ready for utilization or consumption, or it may be semi-finished to become an input for an establishment engaged in further manufacturing. For example, the product of the alumina refinery is the input used in the primary production of aluminum; primary aluminum is the input to an aluminum wire drawing plant; and aluminum wire is the input for a fabricated wire product manufacturing establishment.\n\nThe subsectors in the Manufacturing sector generally reflect distinct production processes related to material inputs, production equipment, and employee skills. In the machinery area, where assembling is a key activity, parts and accessories for manufactured products are classified in the industry of the finished manufactured item when they are made for separate sale. For example, an attachment for a piece of metalworking machinery would be classified with metalworking machinery. However, component inputs from other manufacturing establishments are classified based on the production function of the component manufacturer. For example, electronic components are classified in Subsector 334, Computer and Electronic Product Manufacturing, and stampings are classified in Subsector 332, Fabricated Metal Product Manufacturing.\n\nManufacturing establishments often perform one or more activities that are classified outside the Manufacturing sector of NAICS. For instance, almost all manufacturing has some captive research and development or administrative operations, such as accounting, payroll, or management. These captive services are treated the same as captive manufacturing activities. When the services are provided by separate establishments, they are classified in the NAICS sector where such services are primary, not in manufacturing.\n\nThe boundaries of manufacturing and the other sectors of the classification system can be somewhat blurry. The establishments in the Manufacturing sector are engaged in the transformation of materials into new products. Their output is a new product. However, the definition of what constitutes a new product can be somewhat subjective. As clarification, the following activities are considered manufacturing in NAICS:\n\nMilk bottling and pasteurizing;\n\nWater bottling and processing;\n\nFresh fish packaging (oyster\nshucking, fish filleting);\n\nApparel jobbing (assigning\nmaterials to contract\nfactories or shops for\nfabrication or other contract\noperations) as well as\ncontracting on materials\nowned by others;\n\nPrinting and related activities;\n\nReady-mix concrete production;\n\nLeather converting;\n\nGrinding lenses to\nprescription;\n\nWood preserving;\n\nLapidary work for the trade;\n\nElectroplating, plating, metal\nheat treating, and\npolishing for the trade;\n\nFabricating signs and\nadvertising displays;\n\nRebuilding or remanufacturing\nmachinery (i.e., automotive\nparts);\n\nMaking manufactured homes\n(i.e., mobile homes) or\nprefabricated buildings,\nwhether or not assembling/\nerecting at the customers'\nsite;\n\nShip repair and renovation;\n\nMachine shops; and\n\nTire retreading.\n\nConversely, there are activities that are sometimes considered manufacturing, but which for NAICS are classified in another sector (i.e., not classified as manufacturing). They include:\n\n1. Logging, classified in Sector 11, Agriculture, Forestry, Fishing and Hunting, is considered a harvesting operation;\n2. Beneficiating ores and other minerals, classified in Sector 21, Mining, Quarrying, and Oil and Gas Extraction, is considered part of the activity of mining;\n3. Constructing structures, assembling prefabricated buildings, and fabricating at the construction site by contractors are classified in Sector 23, Construction;\n4. Breaking bulk and reselling in smaller lots, including packaging, repackaging, or bottling products, such as liquors or chemicals; assembling and selling computers on a custom basis; sorting and reselling scrap; mixing and selling paints to customer order; and cutting metals to customer order for resale are classified in Sector 42, Wholesale Trade, or Sector 44-45, Retail Trade; and\n5. Publishing and the combined activity of publishing and printing, classified in Sector 51, Information, transform information into a product for which the value to the consumer lies in the information content, not in the format in which it is distributed (i.e., the book or software compact disc).",
"children": [
{
"naics": "311",
"name": "Food Manufacturing"
},
{
"naics": "312",
"name": "Beverage and Tobacco Product Manufacturing"
},
{
"naics": "313",
"name": "Textile Mills"
},
{
"naics": "314",
"name": "Textile Product Mills"
},
{
"naics": "315",
"name": "Apparel Manufacturing"
},
{
"naics": "316",
"name": "Leather and Allied Product Manufacturing"
},
{
"naics": "321",
"name": "Wood Product Manufacturing"
},
{
"naics": "322",
"name": "Paper Manufacturing"
},
{
"naics": "323",
"name": "Printing and Related Support Activities"
},
{
"naics": "324",
"name": "Petroleum and Coal Products Manufacturing"
},
{
"naics": "325",
"name": "Chemical Manufacturing"
},
{
"naics": "326",
"name": "Plastics and Rubber Products Manufacturing"
},
{
"naics": "327",
"name": "Nonmetallic Mineral Product Manufacturing"
},
{
"naics": "331",
"name": "Primary Metal Manufacturing"
},
{
"naics": "332",
"name": "Fabricated Metal Product Manufacturing"
},
{
"naics": "333",
"name": "Machinery Manufacturing"
},
{
"naics": "334",
"name": "Computer and Electronic Product Manufacturing"
},
{
"naics": "335",
"name": "Electrical Equipment, Appliance, and Component Manufacturing"
},
{
"naics": "336",
"name": "Transportation Equipment Manufacturing"
},
{
"naics": "337",
"name": "Furniture and Related Product Manufacturing"
},
{
"naics": "339",
"name": "Miscellaneous Manufacturing"
}
],
"exclusions": []
}
}Search by activity
Parameters 3
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.industry.search("coffee shop", { limit: 3 });
console.log(result);Run on your server with a secret key. Calling from a browser or app?
{
"q": "coffee shop",
"country": "US",
"year": 2022,
"results": [
{
"naics": "722515",
"name": "Snack and Nonalcoholic Beverage Bars",
"level": 6,
"parent": "72251",
"parent_name": "Restaurants and Other Eating Places",
"match": {
"field": "term",
"text": "Coffee shops, on premise brewing",
"corrections": []
}
}
]
}Send q with 1-100 characters. Search matches industry names and activity terms. limit defaults to 10 and accepts 1-50. The response contains q, country, year, and a results array of industry records. No matches returns an empty array.
Each search result adds match with the winning field (name, term, or naics), its original text, and corrections. If ordinary search finds no results, small spelling errors can match nearby words. For example, cofee shop matches coffee shops and reports { from: "cofee", to: "coffee" }. Ordinary matches have an empty corrections array.
Request ?deep=true on a paid plan and review deep.description and deep.exclusions to choose the code that fits the business activity. Each exclusion has a description and linked codes. General guidance can have an empty codes array. Store country and year alongside the code. This endpoint covers the US 2022 classification. Search puts country and year on the envelope; optional deep belongs to each result.
Deep
?deep=true Industry definition, child categories and classification exclusions. Included on paid plans.
Run this Deep example with a paid-plan key. Deep is included in the pooled request, with no separate lookup charge.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.industry("541511", { deep: true });
console.log(result);Run on your server with a secret key. Calling from a browser or app?
{
"naics": "541511",
"name": "Custom Computer Programming Services",
"level": 6,
"parent": "54151",
"parent_name": "Computer Systems Design and Related Services",
"country": "US",
"year": 2022,
"deep": {
"description": "This U.S. industry comprises establishments primarily engaged in writing, modifying, testing, and supporting software to meet the needs of a particular customer.",
"children": [],
"exclusions": [
{
"description": "Software design, development, and publishing, or software publishing only--are classified in Industry 513210, Software Publishers;",
"codes": [
{
"naics": "513210",
"name": "Software Publishers"
}
]
},
{
"description": "Providing computing infrastructure, data processing services, Web hosting services (except software publishing), and related services, including streaming support services (except streaming distribution services)--are classified in Industry 518210, Computing Infrastructure Providers, Data Processing, Web Hosting, and Related Services; and",
"codes": [
{
"naics": "518210",
"name": "Computing Infrastructure Providers, Data Processing, Web Hosting, and Related Services"
}
]
},
{
"description": "Planning and designing computer systems that integrate computer hardware, software, and communication technologies, even though such establishments may provide custom software as an integral part of their services--are classified in U.S. Industry 541512, Computer Systems Design Services.",
"codes": [
{
"naics": "541512",
"name": "Computer Systems Design Services"
}
]
}
]
}
}Deep fields
- deep.descriptionstring or null
- Industry definition, or null when unavailable
- deep.childrenarray
- Immediate children with naics and name. Empty for a six-digit industry
- deep.exclusionsarray
- Activities classified elsewhere, each with description and codes containing naics and name. A rule can give general guidance with an empty codes array
Questions? Email