REFERENCE
Field Definitions"MatchRating": "Confident", "NumberOfPostings": 56179, "NumberOfClosedPostings": 56737, "NumberOfHiringCompanies": 24029, "HistoricalHiringCompanies": 20691, "Posting25": 62818, "Posting50": 71399, "Posting75": 80307, "AveragePostingDuration": 30.4, "CurrencyCode": "USD", "DataScope_IndustryCode": "ALL", "DataScope_IndustryName": "All Industries", "DataScope_FTERange": "ALL", "DataScope_CountryCode": "USA", "DateRange_Start": "2024-01-01", "DateRange_End": "2024-09-01", "OnlyPosted": true
CountryCode/Region/State/City: Geographic info aligned with the request. The finest granularity is city, if the returned data is city level, this will be clear in the DataScope_ fields in the API response.
IndustryCode/Name: A standardized numerical representation used to classify businesses and organizations of the returned postings data. We return a 6-digit NAICS code as the industry code along with the corresponding NAICS title as the industry name per North American Industry Classification System.
FTERange: Returns a range value based on the provided FTE (Full-Time Equivalent) Value. If the provided value does not match any of our predefined FTE ranges, “ALL” is returned for this field.
"MatchRating": "Confident", "NumberOfPostings": 19851, "NumberOfClosedPostings": 93065, "NumberOfHiringCompanies": 9642, "HistoricalHiringCompanies": 32689, "Posting25": 64921, "Posting50": 72900, "Posting75": 81396, "AveragePostingDuration": 28.9, "PercentRemote": 0.0413, "PercentSignOnBonus": 0.0053, "GrowthRates": { "PostingMedianRate": 0.0007, "NumberOfPostingRate": 0.3994, "HiringCompanyRate": 0.4565, "AverageDurationRate": -0.3312 }, "BaseDistribution": [ { "BaseDistributionId": 1, "RangeMin": 0, "RangeMax": 14579.9248, "NumberOfPostings": 0, "NumberOfHiringCompanies": 0 }, { "BaseDistributionId": 2, "RangeMin": 14579.9248, "RangeMax": 29159.8496, "NumberOfPostings": 0, "NumberOfHiringCompanies": 0 }, { "BaseDistributionId": 3, "RangeMin": 29159.8496, "RangeMax": 43739.7734, "NumberOfPostings": 347, "NumberOfHiringCompanies": 266 }, { "BaseDistributionId": 4, "RangeMin": 43739.7734, "RangeMax": 58319.6992, "NumberOfPostings": 2335, "NumberOfHiringCompanies": 1380 }, { "BaseDistributionId": 5, "RangeMin": 58319.6992, "RangeMax": 72899.625, "NumberOfPostings": 7207, "NumberOfHiringCompanies": 4291 }, { "BaseDistributionId": 6, "RangeMin": 72899.625, "RangeMax": 87479.5469, "NumberOfPostings": 6658, "NumberOfHiringCompanies": 3811 }, { "BaseDistributionId": 7, "RangeMin": 87479.5469, "RangeMax": 102059.4766, "NumberOfPostings": 1428, "NumberOfHiringCompanies": 1004 }, { "BaseDistributionId": 8, "RangeMin": 102059.4766, "RangeMax": 116639.3984, "NumberOfPostings": 591, "NumberOfHiringCompanies": 376 }, { "BaseDistributionId": 9, "RangeMin": 116639.3984, "RangeMax": 131219.3281, "NumberOfPostings": 404, "NumberOfHiringCompanies": 238 }, { "BaseDistributionId": 10, "RangeMin": 131219.3281, "RangeMax": 353600, "NumberOfPostings": 881, "NumberOfHiringCompanies": 334 } ], "CurrencyCode": "USD", "DataScope_IndustryCode": "ALL", "DataScope_IndustryName": "All Industries", "DataScope_FTERange": "ALL", "DataScope_CountryCode": "USA", "DateRange_Start": "2024-08-01", "DateRange_End": "2024-09-01", "OnlyPosted": true
This endpoint returns all of the fields previously defined as well as the following.
PostingMedianRate: Represents the percentage change in the median value of job postings (Posting50) for the requested period.
If requested a date range other than today, the rate is calculated as
If requested to show today’s data, the rate is calculated as
NumberOfPostingRate:Represents the percentage change in the number of job postings compared to the average number of postings over the specified date range.
The calculation is as follows:
Average Posting Count Calculation:
For date ranges of 14 days or less, daily counts are used. For date ranges between 15 days and 6 months, bi-weekly averages are used. For date ranges over 6 months, monthly or quarterly averages are applied. If the date range does not align perfectly with these periods, the averages are adjusted by combining them with additional days.
HiringCompanyRate: Represents the percentage change in the number of unique hiring companies compared to the average number of hiring companies over the specified date range. The calculation is as follows:
AverageDurationRate: Represents the percentage change in the average duration of job postings compared to the average duration over the specified date range. It is calculated using the formula:
For 1 posting, only 1 distribution group is shown, with the range representing the posting’s salary min-max.
For 2 to 5 postings, there are always 2 distribution groups displayed.
For more than 5 postings, an additional distribution group is added for every 5 postings, up to a maximum of 10 distribution groups.
BaseDistributionId: An integer field that represents the number of distribution groups allocated based on the returned postings data. The value of BaseDistributionId is determined by the number of postings with salary data, and it ranges from 1 to a maximum of 10.
RangeMin: The minimum value of the salary range for a specific distribution group. Each distribution group represents a portion of the salary data, and RangeMin defines the lowest salary within that group. This field is dynamically calculated based on the salary data returned and varies depending on the number of postings and groups created. 4 decimal places.
RangeMax: The maximum value of the salary range for a specific distribution group. This field represents the upper limit of salaries within that distribution group. The RangeMax value, along with RangeMin, helps define the boundaries of the salary distribution for each group. It is dynamically determined based on the salary data of the returned postings and varies according to the number of postings and the corresponding distribution groups created. 4 decimal places.
NumberOfPostings: The total number of postings counted within each distribution group. If multiple companies posted the same job title, it is counted multiple times.
NumberOfHiringCompanies: This field represents the total number of unique hiring companies within each distribution group. Even if a single company has multiple postings in the same salary range distribution group, it will only be counted once.