{"openapi":"3.1.0","info":{"title":"NAICS API","version":"1.0.0","description":"The North American Industry Classification System (NAICS 2022) as an API — 2,100+ industry codes in a 5-level hierarchy (sector → subsector → industry group → industry → national industry). Look up any code (e.g. 541511 → Custom Computer Programming Services) with its full ancestor chain and direct children; search industries by title (e.g. \"software\", \"restaurant\"); or navigate the tree from the 20 top-level sectors down. NAICS is the standard used by US, Canadian and Mexican statistical agencies to classify business establishments. Ideal for business classification, market research, CRM enrichment, lead segmentation and economic analysis.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/naics-api","description":"oanor gateway"}],"tags":[{"name":"NAICS"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/children":{"get":{"operationId":"get_v1_children","tags":["NAICS"],"summary":"Direct children of a code (or all sectors)","description":"","parameters":[{"name":"code","in":"query","required":false,"description":"Parent code, e.g. 54 (omit to list all 20 sectors)","schema":{"type":"string"},"example":"54"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"54","count":1,"level":"sector","title":"Professional, Scientific, and Technical Services","children":[{"code":"541","level":"subsector","title":"Professional, Scientific, and Technical Services","parent":"54"}]},"meta":{"timestamp":"2026-05-31T04:30:16.388Z","request_id":"935e5408-bc3f-4d1a-bff3-189ab8c448dc"},"status":"ok","message":"Children listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/code":{"get":{"operationId":"get_v1_code","tags":["NAICS"],"summary":"A NAICS code with ancestors + children","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"2-6 digit NAICS code, e.g. 541511","schema":{"type":"string"},"example":"541511"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"541511","level":"national_industry","title":"Custom Computer Programming Services","parent":"54151","children":[],"ancestors":[{"code":"54","level":"sector","title":"Professional, Scientific, and Technical Services"},{"code":"541","level":"subsector","title":"Professional, Scientific, and Technical Services","parent":"54"},{"code":"5415","level":"industry_group","title":"Computer Systems Design and Related Services","parent":"541"},{"code":"54151","level":"industry","title":"Computer Systems Design and Related Services","parent":"5415"}],"children_count":0},"meta":{"timestamp":"2026-05-31T04:30:16.462Z","request_id":"3a25a187-898a-41ac-9d2a-1250f7b3d4d7"},"status":"ok","message":"NAICS code retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["NAICS"],"summary":"Search industries by title","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Title search, e.g. software","schema":{"type":"string"},"example":"software"},{"name":"level","in":"query","required":false,"description":"sector | subsector | industry_group | industry | national_industry","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"limit":20,"query":"software","total":5,"offset":0,"results":[{"code":"42343","level":"industry","title":"Computer and Computer Peripheral Equipment and Software Merchant Wholesalers","parent":"4234"},{"code":"423430","level":"national_industry","title":"Computer and Computer Peripheral Equipment and Software Merchant Wholesalers","parent":"42343"},{"code":"5132","level":"industry_group","title":"Software Publishers","parent":"513"},{"code":"51321","level":"industry","title":"Software Publishers","parent":"5132"},{"code":"513210","level":"national_industry","title":"Software Publishers","parent":"51321"}]},"meta":{"timestamp":"2026-05-31T04:30:16.533Z","request_id":"03a12f86-4d70-4b48-aafb-e82389a95b2c"},"status":"ok","message":"NAICS codes listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & level breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"5-level hierarchy. Sectors may be ranges (e.g. 31-33 Manufacturing). Codes are North American (US/CA/MX) standard.","total":2125,"fields":["code","title","level","parent","ancestors","children"],"levels":[{"count":20,"level":"sector"},{"count":96,"level":"subsector"},{"count":308,"level":"industry_group"},{"count":689,"level":"industry"},{"count":1012,"level":"national_industry"}],"source":"U.S. Census Bureau — NAICS 2022 (2-6 digit codes)","version":"2022"},"meta":{"timestamp":"2026-05-31T04:30:16.604Z","request_id":"a3e62d02-1208-492f-bddf-b62ece05a9a3"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":400,"monthly_call_quota":70000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1100,"monthly_call_quota":350000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2900,"monthly_call_quota":1800000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/naics-api"}