NAICS Industry Code Lookup (by Company Domain or Name)

{
  "type": "object",
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "minLength": 4,
      "description": "Brand domain (preferred, e.g. 'example.com') or company title. A valid domain is classified directly; otherwise the upstream service searches for the brand by title first."
    },
    "timeoutMS": {
      "type": "integer",
      "maximum": 300000,
      "minimum": 1000,
      "description": "Upstream timeout in milliseconds (max 300000). The upstream service aborts the call with a 408 when exceeded. Keep it below the endpoint's requestTimeoutMs so the provider answers before the platform's own budget expires."
    },
    "maxResults": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of codes to return (1-10). Default 5."
    },
    "minResults": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1,
      "description": "Minimum number of codes to return (1-10). Default 1."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "An upstream error code, only present when classification failed, e.g. 'HTTP_400' for an unresolvable company title."
    },
    "type": {
      "type": "string",
      "description": "Observed value: \"naics\" on the one successful classification captured."
    },
    "codes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "A 2022 NAICS industry code, e.g. '456110'."
          },
          "name": {
            "type": "string",
            "description": "The NAICS code's own official industry description, e.g. 'Pharmacies and Drug Retailers' -- not a person's or a company's name."
          },
          "confidence": {
            "type": "string",
            "description": "Observed value: \"medium\" on every code in the one captured fixture. Other levels (e.g. \"high\", \"low\") are documented by the endpoint but unconfirmed against a real response."
          }
        },
        "additionalProperties": true
      },
      "description": "The matched NAICS 2022 codes, most likely first. Length is governed by `minResults`/`maxResults` on the request; the one captured fixture returned 5 entries."
    },
    "domain": {
      "type": "string",
      "description": "The domain the classification was resolved against, e.g. 'amazon.com'."
    },
    "status": {
      "type": "string",
      "description": "Observed value: \"ok\" on the one successful classification captured."
    },
    "message": {
      "type": "string",
      "description": "A human-readable message paired with `code`, only present on failure."
    }
  },
  "description": "The classification result, as returned at the result path. A successful match carries `domain`, `codes`, `type`, and `status`; a company the endpoint could not resolve instead carries only `code` and `message` describing the failure (observed directly: examples/unknown-title-empty.json). The two shapes do not overlap at the top level.",
  "additionalProperties": true
}