jobdata

Removal of clearance_required field from job result structure

jobdataapi.com v4.2 / API version 1.7

0 min read · Aug. 21, 2024

We removed the field clearance_required from the job result structure. This affects all job results on the /api/jobs/ endpoint.

The main reason for this is that this was kind of a legacy part of the initial database structure and seemed to be rarely used/needed by anyone. Adding to this, the info stored in this field (a simple boolean) can be quite easily derived from the field description_string (+ job title in some cases) with a few search keywords, to determine if a job ad lists a security clearance (or the ability to obtain one) as a requirement for a job. A filter parameter for this didn't exist before, it was only part of the result set.

In case you were utilizing this info before you might want to check out this tutorial as a starting point for doing it in your own backend: How to Determine if a Job Post Requires Security Clearance). It was basically our approach, nothing fancy.

This change was part of a recent database/backend refactoring and migration effort to keep things as lean and simple as possible.

Related Docs

GeoNames upgrade, new population field and filters, expired field now in job results
Added Remote Work Mode Classification
Improved API query validation
Added company website/domain filter to jobs endpoint
Full job data downloads now available!
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
API access key management upgrades + company timestamps in Companies API
Added salary estimates + global currency conversion API endpoint
Job filtering by vector embedding now available + added Apprenticeship job type
Introducing Vector Embeddings and Vector Search in the jobdata API
Added Role Taxonomy Tags Endpoint + Job Role Filters
Change of length for job title and location fields
Added source/ATS and company filtering + source ID fields
Query behavior changes for application_url, title, and location filters
Enhanced Company HQ Data + new Geographic Filters
Added API Access Lite Plan + Smarter Age-Window Defaults for Jobs API
Maximum value for "page_size" parameter increased to 5000
Added plain-text field for cleaned job description
New location, ID fields and filters
Enhanced multi-value parameters for Job and Company queries