ParseAPI Industry API

Find an industry by code or business activity.

GitHub OpenAPI

Operations 2

GET /industry/{code} Look up a US NAICS industry code #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-industry-api"
All apis
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.

Get an API 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 Specification

parseapi-com-industry-api-openapi.yml Raw ↑
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'