naics.com APInaics.com ↗
Access NAICS codes, sector titles, industry descriptions, SIC crosswalks, and top business data via 3 endpoints covering the full NAICS hierarchy.
curl -X GET 'https://api.parse.bot/scraper/f1afe320-6d6a-4881-9e6e-8c56d1a1dd93/get_all_codes?sector=23' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all NAICS codes with their titles, hierarchy level, and sector information. Returns 2-digit sector codes, 4-digit industry group codes, and 6-digit national industry codes. Can optionally filter by sector.
| Param | Type | Description |
|---|---|---|
| sector | string | Filter by 2-digit sector code (e.g., '11', '23', '54'). If omitted, returns all sectors. |
| version | string | NAICS version year. |
{
"type": "object",
"fields": {
"codes": "array of NAICS code objects each containing naics_code, title, level, code_length, sector_code, and sector_title",
"version": "string - NAICS version year",
"total_codes": "integer - total number of codes returned",
"sector_filter": "string or null - sector filter applied, if any"
},
"sample": {
"data": {
"codes": [
{
"level": "sector",
"title": "Construction",
"naics_code": "23",
"code_length": 2,
"sector_code": "23",
"sector_title": "Construction"
},
{
"level": "industry_group",
"title": "Residential Building Construction",
"naics_code": "2361",
"code_length": 4,
"sector_code": "23",
"sector_title": "Construction"
},
{
"level": "national_industry",
"title": "New Single-Family Housing Construction (except For-Sale Builders)",
"naics_code": "236115",
"code_length": 6,
"sector_code": "23",
"sector_title": "Construction"
}
],
"version": "2022",
"total_codes": 42,
"sector_filter": "23"
},
"status": "success"
}
}About the naics.com API
The naics.com API exposes the full North American Industry Classification System across 3 endpoints, returning 2-digit sector codes, 4-digit industry group codes, and 6-digit national industry codes with titles and descriptions. The get_code_details endpoint goes further, returning a narrative industry description, index entry terms, top businesses by annual sales, and cross-references to related NAICS codes — all for a single code lookup.
Browsing and Filtering the Full Code Hierarchy
The get_all_codes endpoint returns every NAICS code in the dataset with fields for naics_code, title, level, code_length, sector_code, and sector_title. You can narrow results by passing a 2-digit sector parameter — for example, '54' for Professional, Scientific, and Technical Services — or request the full set by omitting it. A version parameter lets you target a specific NAICS revision year, useful when classification changes between census cycles matter for your application.
Keyword Search with SIC Crosswalk
The search_codes endpoint accepts a plain-text query and returns matching codes with their title, associated keywords, and sic_crosswalk data. The SIC crosswalk field is particularly useful for projects that need to reconcile older Standard Industrial Classification codes with their NAICS equivalents. total_results is included in the response so you can assess coverage without iterating the full result array.
Detailed Code Profiles
For a specific 6-digit code, get_code_details returns a structured profile: a prose description of the industry, an index_entries array listing the index terms mapped to that code, a top_businesses array ranked by annual sales, and a cross_references array pointing to related classifications. This level of detail supports use cases ranging from business registration assistance to competitive intelligence profiling by industry segment.
- Map a business description to the correct 6-digit NAICS code using keyword search and SIC crosswalk data.
- Build a sector browser that lists all codes within a given 2-digit sector, using the
sectorfilter inget_all_codes. - Populate industry dropdowns in business registration or tax forms with accurate NAICS titles and codes.
- Reconcile legacy SIC codes to current NAICS codes for dataset normalization or compliance reporting.
- Identify the top businesses by annual sales in a given industry segment via
top_businessesinget_code_details. - Generate industry classification suggestions for company profiles by matching business names or descriptions against NAICS index entries.
- Track classification changes across NAICS revision years using the
versionparameter across endpoints.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does naics.com have an official developer API?+
What does `get_code_details` return beyond a code's title?+
description of the industry, an index_entries array of classification terms, a top_businesses array ranked by annual sales, and a cross_references array describing related NAICS codes. All fields are scoped to the single code you pass in the code parameter.Does the API return 3-digit subsector or 5-digit industry codes, or only 2-, 4-, and 6-digit codes?+
get_all_codes endpoint documents three levels: 2-digit sector, 4-digit industry group, and 6-digit national industry codes. Three-digit subsector and 5-digit NAICS industry codes are not currently exposed. You can fork this API on Parse and revise it to add an endpoint targeting those intermediate levels if your classification workflow requires them.Can I retrieve parent-child relationships between codes, such as which 6-digit codes belong to a given 4-digit group?+
get_all_codes response includes sector_code and sector_title on each record, which lets you group codes by sector, but a structured parent-child nesting is not returned. You can fork this API on Parse and revise it to build a hierarchical grouping from the returned fields.How current is the NAICS data, and can I access older versions?+
version parameter for specifying the NAICS revision year. The response always echoes back the version that was used, so you can confirm which edition the data reflects. Coverage of specific historical versions depends on what naics.com publishes.