NAICS APInaics.com ↗
Access NAICS codes, sector titles, industry descriptions, SIC crosswalks, and top business data via 3 endpoints covering the full NAICS hierarchy.
What is the NAICS 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.
curl -X GET 'https://api.parse.bot/scraper/f1afe320-6d6a-4881-9e6e-8c56d1a1dd93/get_all_codes?sector=11&version=2022' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace naics-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.naics_code_lookup_api import Naics, Code, CodeSummary, TaxonomyCode
client = Naics()
# Search for software-related NAICS codes
for summary in client.codesummaries.search(query="software"):
print(summary.naics_code, summary.title, summary.keywords)
# Drill into the first result's full details
first = next(iter(client.codesummaries.search(query="construction")))
detail = first.details()
print(detail.naics_code, detail.title, detail.description)
for ref in detail.cross_references:
print(ref.text, ref.code)
# Browse taxonomy codes filtered by sector
for entry in client.taxonomycodes.list(sector="54"):
print(entry.naics_code, entry.title, entry.level, entry.code_length)
# Fetch a specific code directly by its identifier
code = client.codes.get(code="541511")
print(code.title, code.description)
for biz in code.top_businesses:
print(biz)
Retrieve 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. Optionally filter by 2-digit sector prefix to narrow to one sector's hierarchy. Without a sector filter the full taxonomy is returned (1000+ codes).
| Param | Type | Description |
|---|---|---|
| sector | string | 2-digit sector code to filter by (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": "Agriculture, Forestry, Fishing and Hunting",
"naics_code": "11",
"code_length": 2,
"sector_code": "11",
"sector_title": "Agriculture, Forestry, Fishing and Hunting"
},
{
"level": "industry_group",
"title": "Oilseed and Grain Farming",
"naics_code": "1111",
"code_length": 4,
"sector_code": "11",
"sector_title": "Agriculture, Forestry, Fishing and Hunting"
}
],
"version": "2022",
"total_codes": 84,
"sector_filter": "11"
},
"status": "success"
}
}About the NAICS API
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.
The NAICS API is a managed, monitored endpoint for naics.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when naics.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official naics.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.