Skip to main content
POST
Classify companies

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Full shape is under Schema; example is minimal.

yes
string[]
required

Company numbers to include.

no
string[]
required

Company numbers to exclude.

returnCount
integer

Response

200 - application/json

Classify / score results from the product API.

Filtered / classify list response from the product API. Top-level keys use camelCase JSON (companies, insights); the ListInsights component schema describes the shape of the insights object, not its JSON key name.

companies
(object | string)[]

Company objects (ClassifiedCompany) or plain company number strings when ReturnCompanyIDsOnly is set.

Generated from The Data City data dictionary (schema ClassifiedCompany, version 1.0). See https://docs.thedatacity.com/data-dictionary/

insights
object | null

Present when the insights query parameter is true and the token supports it. Field names inside this object are PascalCase (see data dictionary / ListInsights schema).

CompanyChanges
object[] | null

Omitted without companies:changes.

JobPostingsBySOC4Code
object[] | null

Omitted without lightcast:read.

JobPostingsBySOC4Name
object[] | null

Omitted without lightcast:read.

JobPostingsByLotName
object[] | null

Omitted without lightcast:read.

AverageAdvertisedSalaryBySOC4Code
object[] | null

Omitted without lightcast:read.

AverageAdvertisedSalaryBySOC4Name
object[] | null

Omitted without lightcast:read.

AverageAdvertisedSalaryByLotName
object[] | null

Omitted without lightcast:read.

JobPostingsBySkill
object[] | null

Omitted without lightcast:read.

AveragePostingDurationBySkill
object[] | null

Omitted without lightcast:read.

RTICJobPostings
object[] | null

Omitted without lightcast:read.

RTICVerticalJobPostings
object[] | null

Omitted without lightcast:read.

CICJobPostings
object[] | null

Omitted without lightcast:read.

CICVerticalJobPostings
object[] | null

Omitted without lightcast:read.

CompanyJobPostingsOverTimeBySOC4
object[] | null

Omitted without lightcast:read.

CompanyJobPostingsOverTimeByLOT
object[] | null

Omitted without lightcast:read.

JobPostingsByCommonSkill
object[] | null

Omitted without lightcast:read.

AveragePostingDurationByCommonSkill
object[] | null

Omitted without lightcast:read.

JobPostingsByCertificationsSkill
object[] | null

Omitted without lightcast:read.

AveragePostingDurationByCertificationsSkill
object[] | null

Omitted without lightcast:read.

JobPostingsBySpecializedSkill
object[] | null

Omitted without lightcast:read.

AveragePostingDurationBySpecializedSkill
object[] | null

Omitted without lightcast:read.

JobPostingInsights
object[] | null

Omitted without lightcast:read.

JobPostingInsightsLOT
object[] | null

Omitted without lightcast:read.

Last modified on August 14, 2026