Search by task, endpoint, field, or error.
NAICS Code 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.naics("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
- naics
- Canonical NAICS code as a string. Combined sectors use 31-33, 44-45, or 48-49
- name
- Official industry name
- level
- Hierarchy level from 2 (sector) to 6 (national industry)
- parent
- Immediate parent code, or null for a sector
- parent_name
- Immediate parent name, or null for a sector
- country
- Classification country. US
- year
- Classification revision. 2022
- match
- 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.
Search by activity
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.naics.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.
Deep examples run with your own key. Check this API’s included units and pricing before running.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.naics("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.description
- Industry definition, or null when unavailable
- deep.children
- Immediate children with naics and name. Empty for a six-digit industry
- deep.exclusions
- 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