ParseAPI Industry API
Find an industry by code or business activity.
Find an industry by code or business activity.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-industry-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Parse Industry API
version: 1.0.0
summary: Fast APIs for developers, locate, validate, decode.
description: 'One base URL, one key, minimal JSON. Response schemas describe API 2.3.0. Paid plans include their profile detail automatically at its natural resource homes; Free returns the complete ordinary answer. There is no deep response object. When neither version header is sent, requests use the saved team default, or 1.0.0 for keyless self-lookups. Read https://parseapi.com/docs/versioning for other supported contracts. Responses that reach the organization rate check carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Optional X-RateLimit-Burst indicates continuous refill. Rate-limit 429 responses add Retry-After (seconds). See https://parseapi.com/agents and https://parseapi.com/llms.txt for agent-oriented guidance. Field-level docs: https://parseapi.com/docs Free-plan users must include a link to ParseAPI on their website, app, or project documentation. A footer, about page, credits page, or another reasonable location is fine. Paid plans do not require ParseAPI attribution. Example HTML: Data provided by ParseAPI. Details: https://parseapi.com/legal/attribution#crediting-parseapi.'
termsOfService: https://parseapi.com/legal/terms
contact:
name: ParseAPI
email: hello@parseapi.com
url: https://parseapi.com
servers:
- url: https://api.parseapi.com
description: Production
tags:
- name: Industry
description: Find an industry by code or business activity.
externalDocs:
description: Industry API docs
url: https://parseapi.com/docs/industry
paths:
/industry/{code}:
get:
operationId: industry
tags:
- Industry
summary: Look up a US NAICS industry code
description: 'US NAICS 2022 industry name, hierarchy level and immediate parent. Paid deep adds definition, children and classification exclusions. Exclusion descriptions retain general guidance, with linked codes for explicit destinations. Canonical combined sectors are 31-33, 44-45, and 48-49. Their individual two-digit aliases resolve to the combined sector. One pooled request on every plan. Malformed code is 400 and an unknown code is 404. Full field reference: https://parseapi.com/docs/industry'
security:
- ApiKeyAuth: []
- BearerAuth: []
parameters:
- $ref: '#/components/parameters/ParseVersion'
- name: code
in: path
required: true
description: A 2-6 digit NAICS code or combined sector
schema:
type: string
example: '541511'
- name: deep
in: query
required: false
description: Industry definition, child categories and classification exclusions. Included automatically on paid plans in API 2.2.
schema:
type: boolean
responses:
'200':
description: Success, minimal JSON object (shape varies by endpoint)
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
X-API-Version:
description: The exact response contract selected for this request.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
content:
application/json:
schema:
type: object
required:
- naics
- name
- level
- parent
- parent_name
- country
- year
properties:
naics:
type: string
name:
type: string
level:
type: integer
minimum: 2
maximum: 6
parent:
type:
- string
- 'null'
parent_name:
type:
- string
- 'null'
country:
type: string
const: US
year:
type: integer
const: 2022
description:
type:
- string
- 'null'
children:
type: array
items:
type: object
required:
- naics
- name
properties:
naics:
type: string
name:
type: string
exclusions:
type: array
description: Activities classified elsewhere. An empty array means this code has no published exclusions.
items:
type: object
required:
- description
- codes
properties:
description:
type: string
codes:
type: array
items:
type: object
required:
- naics
- name
properties:
naics:
type: string
name:
type: string
description: Explicit destination codes. General guidance may have no specific destination.
'400':
description: invalid_request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: invalid_api_key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: permission_denied or plan_required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: not_found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'410':
description: api_version_retired
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: rate_limited or quota_exceeded
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: server_error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: service_unavailable
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/industry:
get:
operationId: industry_search
tags:
- Industry
summary: Search NAICS industries by business activity
description: 'Search US NAICS 2022 industry names and activity terms. Results contain classification identity and parent context, plus match, identifying the winning name, term, or code and any spelling corrections. Country and revision are on the search envelope. Bounded typo matching runs only when ordinary search has no results. Ranking indicates text relevance, not classification confidence. No matches returns results: []. One pooled request. Full field reference: https://parseapi.com/docs/industry'
security:
- ApiKeyAuth: []
- BearerAuth: []
parameters:
- $ref: '#/components/parameters/ParseVersion'
- name: q
in: query
required: true
description: Business activity or industry keyword
schema:
type: string
minLength: 1
maxLength: 100
example: coffee shop
- name: limit
in: query
required: false
description: Maximum matching industries
schema:
type: integer
minimum: 1
maximum: 50
default: 10
- name: deep
in: query
required: false
description: Industry definition, child categories and classification exclusions. Included automatically on paid plans in API 2.2.
schema:
type: boolean
responses:
'200':
description: Success, minimal JSON object (shape varies by endpoint)
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
X-API-Version:
description: The exact response contract selected for this request.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
content:
application/json:
schema:
type: object
required:
- q
- country
- year
- results
properties:
q:
type: string
country:
type: string
const: US
year:
type: integer
const: 2022
results:
type: array
items:
type: object
required:
- naics
- name
- level
- parent
- parent_name
- match
properties:
naics:
type: string
name:
type: string
level:
type: integer
minimum: 2
maximum: 6
parent:
type:
- string
- 'null'
parent_name:
type:
- string
- 'null'
match:
type: object
required:
- field
- text
- corrections
properties:
field:
type: string
enum:
- name
- term
- naics
text:
type: string
description: The actual name, activity term, or code that ranked this result.
corrections:
type: array
description: Spelling matches as normalized query words and their matched words. Empty for ordinary matches.
items:
type: object
required:
- from
- to
properties:
from:
type: string
to:
type: string
description:
type:
- string
- 'null'
children:
type: array
items:
type: object
required:
- naics
- name
properties:
naics:
type: string
name:
type: string
exclusions:
type: array
description: Activities classified elsewhere. An empty array means this code has no published exclusions.
items:
type: object
required:
- description
- codes
properties:
description:
type: string
codes:
type: array
items:
type: object
required:
- naics
- name
properties:
naics:
type: string
name:
type: string
description: Explicit destination codes. General guidance may have no specific destination.
'400':
description: invalid_request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: invalid_api_key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: permission_denied or plan_required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: not_found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'410':
description: api_version_retired
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: rate_limited or quota_exceeded
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: server_error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: service_unavailable
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
parameters:
ParseVersion:
name: X-API-Version
in: header
required: false
description: Exact response contract for this lookup. Overrides the saved team default for this request only. Legacy Parse-Version is also accepted; both headers must match if sent together. With neither header, keyed requests use that default and keyless self-lookups use 1.0.0. Invalid or unsupported values return invalid_request (400). Retired selections return api_version_retired (410). Reference/help URLs keep their documented version and do not use this selector.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
example: 2.3.0
schemas:
Error:
type: object
required:
- code
- message
- docs
- request_id
properties:
code:
type: string
description: Machine-readable error code
enum:
- invalid_request
- ambiguous_time
- nonexistent_time
- invalid_api_key
- permission_denied
- plan_required
- not_found
- api_version_retired
- rate_limited
- quota_exceeded
- server_error
- service_unavailable
- dns_resolution_failed
- task_invalid
- task_not_found
- task_request_conflict
- task_budget_exceeded
- task_limit_exceeded
- task_terms_changed
- task_expired
- task_cancelled
- task_in_progress
- task_outcome_unknown
- task_unavailable
message:
type: string
docs:
type: string
format: uri
description: Link to the docs section for this error
request_id:
type: string
description: Send this if you contact support
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key from the ParseAPI dashboard
BearerAuth:
type: http
scheme: bearer
description: 'Same key as X-API-Key, via Authorization: Bearer'