Skip to main content
GET
Classify NAICS industries
10 Credits

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <API_KEY>. Keys have full access by default.

Query Parameters

input
string
required

Brand domain or title to retrieve NAICS code for. If a valid domain is provided, it will be used for classification, otherwise, we will search for the brand using the provided title.

Minimum string length: 4
minResults
integer
default:1

Minimum number of NAICS codes to return. Must be at least 1. Defaults to 1.

Required range: 1 <= x <= 10
maxResults
integer
default:5

Maximum number of NAICS codes to return. Must be between 1 and 10. Defaults to 5.

Required range: 1 <= x <= 10
timeoutOpts
object

Optional request deadline and behavior on timeout. For GET requests, use timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded timeoutOpts object.

tags
string[]

Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 characters. Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

Maximum array length: 20
Required string length: 1 - 50
Example:

Response

Successful response

request_id
string<uuid>
required

Unique id of this API call, also sent in the X-Request-Id response header. Quote it when contacting support about a failed request.

Example:

"3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"

partial
boolean

True when the timeout ended processing and this response contains only usable results completed so far. Unfinished results are omitted.

status
string

Status of the response, e.g., 'ok'

domain
string

Domain found for the brand

type
string

Industry classification type, for naics api it will be naics

codes
object[]

Array of NAICS codes and titles.

key_metadata
object

Credit usage, included whenever a valid API key is provided.