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

Added salary estimates and converted values + location_string to download CSVs
Optimized Vector Embeddings & Search
Added YouTube links to company profiles
Added company flag for recruiting/staffing firms + enhanced filtering options
jobdataapi.com now has Changelog section 🎉
Introducing Vector Embeddings and Vector Search in the jobdata API
Added application URL query filter + (multi) country code parameter enhancements
Added Remote Work Mode Classification
Query behavior changes for application_url, title, and location filters
Added salary estimates + global currency conversion API endpoint
Added Role Taxonomy Tags Endpoint + Job Role Filters
Added plain-text field for cleaned job description
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Improved Job States (geo) search, Markdown job descriptions, and lean data retrieval
Added new Job States (geo) endpoint, query filters, and more
Job filtering by vector embedding now available + added Apprenticeship job type
Improved API query validation
Added API Access Lite Plan + Smarter Age-Window Defaults for Jobs API
New location, ID fields and filters
Added company website/domain filter to jobs endpoint