Dictionary: Base Jobs Data

The Base Jobs dataset supporting these fields is deduplicated and collected worldwide. Records date back to August 2020, and active postings are checked within 24 hours through continuous 24/7 discovery. This data dictionary details all available fields, clarifies their values, and includes sample job data.

Data fields per category

1. Metadata

2. Job information

3. Recruiter information

4. Company information

5. Salary

6. Benefits

All personal/company information mentioned within this context is entirely fictional and is solely intended for illustrative purposes.

Metadata

Data field	Description	Data type
source_id	Source-specific job ID	Integer
id	Unified job identifier across all sources	Integer
date_posted	Job ad publish date	Timestamp
posted	Job ad publish time (as displayed on Professional network)	String
valid_through	Expiry date	Timestamp
url	Job posting URL	String
application_active	One of two possible values: 0 – the last time we scraped the job posting, the job posting was deactivated. 1 – the last time we scraped the job posting, it was still active	Integer
deleted	One of two possible values: 0 – job posting is available and was successfully scraped 1 – the last time we scraped the job posting, the Page not found was returned	Integer
created_at	The time and date when we first scraped the record	Timestamp
updated_at	The time and date when we updated the record	Timestamp

Refer to the table example from the data:

Metadata

"source_id": 1234567,
"id": 12345667,
"date_posted":"2025-08-04 18:20:13",
"posted": "4 months ago",
"valid_through": "2025-12-11 19:25:35",
"url": "https://www.professional-network.com/jobs/example",
"application_active": 1,
"deleted": 0,
"created_at": "2025-10-04 20:18:44",
"updated_at": "2025-10-04 20:18:44"

Job information

Data field	Description	Data type
title	Job title	String
description	Job description Note: contains control characters.	String
seniority	Job seniority level	String
employment_type	Standardised values to display one of the values: “Full-time “, “Part-time“, “Contract”, “Temporary“, “Internship“, “Volunteer“	String
external_url	External URL provided by the company referring to the job posting	String
location	Job location	String
country	Job country location	String
country_iso_2	ISO 2-letter code of the location country (based on location and/or country values)	String
country_iso_2	ISO 3-letter code of the location country (based on location and/or country values)	String
state	Job location state (if available)	String
city	Job location city	String
regions	Associated geographical regions based on location and/or country values	Array of strings
latitude	Latitude of location (if available)	Float
longitude	Longitude of location (if available)	Float
required_months_of_experience	Experience in months requirements	Integer
applicants_count	Number of applicants	String
estimated_applicants_count	Estimated number of applicants. E.g., “Be among the first 25 applicants” = -1 “Over 200 applicants” = 200	Integer
functions	Standardized job functions	Array of strings
industries	Listed industries	Array of strings

Refer to the table example from the data:

Job information

"title": "Client Manager",
"description": "Example Company is looking for a new employee. Here is a description of this job offer.",
"seniority": "Not Applicable",
"employment_type": "Full-time",
"external_url": null,
"location": "New York, United States",
"country": "United States",
"country_iso_2": "US",
"country_iso_3": "USA",
"state": "New York",
"city": "New York",
"regions": [
    "Americas",
    "Northern America",
    "AMER"
],
"latitude": 42.939,
"longitude": -75.620,
"required_months_of_experience": 144,
"applicants_count": "200 applicants",
"estimated_applicants_count": 200,
"functions": [
   "Information Technology"
],
"industries": [
   "IT Services and IT Consulting"
],

Recruiter information

Data field	Description	Data type
recruiter	Recruiter information	Struct
profile_url	Recruiter's profile url	String
name	Recruiter's name	String
description	Recruiter's description	String

Refer to the table example from the data:

Recruiter information

 "recruiter": {
    "profile_url": "https://www.professional-network.com/john-doe",
    "name": "John Doe",
    "description": "Find your dream job"
 },

Company information

Data field	Description	Data type
company_id	Company identification key, relating directly to the company table	Long
company	Company information	Struct
name	Company name	String
url	Company profile URL	String
logo_url	Company logo URL	String

Refer to the table example from the data:

Company information

"company_id": 10234567,
"company": {
   "name": "Example Company",
   "url": "http://www.example-company.com",
   "logo_url": "https://www.professional-network.com/logo.png"
}

Salary

Data field	Description	Data type
salary	All salary records for this job	Struct
string	Full and formatted salary field value	String
min_value	Minimum advertised salary	String
max_value	Maximum advertised salary	String
currency	Salary currency	String
unit	The unit of measurement or period associated with the salary values	String

Refer to the table example from the data:

Salary

"salary": {
   "string": "USD 20-35 HOUR",
   "min_value": "20",
   "max_value": "35",
   "currency": "USD",
   "unit": "HOUR"
},

Benefits

Data field	Description	Data type
benefits	Listed position benefits	Array of strings

Refer to the table example from the data:

Benefits

 "benefits": [
    "employee discount",
    "life insurance",
    "paid sick time",
    "vision insurance",
    "dental insurance",
    "health savings account",
    "health insurance"
 ]