jobdata

Removal of clearance_required field from job result structure

jobdataapi.com v4.2 / API version 1.7

0 min read · Aug. 21, 2024 · Markdown version

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
Full job data downloads now available!
Geo radius search expansion for Jobs API location filters
Added company website/domain filter to jobs endpoint
Added salary estimates + global currency conversion API endpoint
Improved API query validation
Job filtering by vector embedding now available + added Apprenticeship job type
Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Added YouTube links to company profiles
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
API access key management upgrades + company timestamps in Companies API
New location, ID fields and filters
Added Role Taxonomy Tags Endpoint + Job Role Filters
Enhanced Company HQ Data + new Geographic Filters
Added plain-text field for cleaned job description
Optimized Vector Embeddings & Search
Added salary estimates and converted values + location_string to download CSVs
Introducing Vector Embeddings and Vector Search in the jobdata API
Change of length for job title and location fields
Enhanced multi-value parameters for Job and Company queries