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 company open/total job counts + filters
Added source/ATS and company filtering + source ID fields
Added plain-text field for cleaned job description
Improved API query validation
Added company website/domain filter to jobs endpoint
Added salary estimates and converted values + location_string to download CSVs
Optimized Vector Embeddings & Search
Enhanced multi-value parameters for Job and Company queries
Job filtering by vector embedding now available + added Apprenticeship job type
Added application URL query filter + (multi) country code parameter enhancements
Introducing Vector Embeddings and Vector Search in the jobdata API
Added `ext_id` filtering to Jobs API + normalized future publish timestamps
Change of length for job title and location fields
New location, ID fields and filters
Added YouTube links to company profiles
API access key management upgrades + company timestamps in Companies API
GeoNames upgrade, new population field and filters, expired field now in job results
Added Role Taxonomy Tags Endpoint + Job Role Filters
Added llms.txt and llms-full.txt for AI-friendly implementation guidance
Added new Job States (geo) endpoint, query filters, and more