Overview
TheJobPost interface represents a single job posting scraped from a job board. It contains all available information about the job, including the title, company, location, compensation, and description.
Interface Definition
Fields
Core Fields
These fields are common across all job boards:Unique identifier for the job posting (may be site-specific)
Job title (e.g., “Senior Software Engineer”)
Name of the hiring company
URL to the job posting on the job board
Direct application URL (bypasses job board, goes to company site)
Full job description text. Format depends on
description_format parameter.URL to the company’s profile page on the job board
Direct URL to the company’s website
Array of job types (e.g.,
[JobType.FULL_TIME, JobType.REMOTE]). See JobType enum.Salary/wage information. See Compensation interface.
Date the job was posted (ISO 8601 format or relative date string)
Contact email addresses extracted from the job posting
Whether the job is remote/work-from-home
Type of listing (e.g., “organic”, “sponsored”)
LinkedIn-Specific Fields
Seniority level (e.g., “Mid-Senior level”, “Entry level”)
Job function/department (e.g., “Engineering”, “Sales”)
Indeed-Specific Fields
Physical addresses of the company
Number of employees at the company (e.g., “1,000-5,000”)
Company revenue information
Description of the company
URL to the company’s logo image
URL to the company’s banner/header image
Naukri-Specific Fields
Required skills for the job
Years of experience required (e.g., “2-5 years”)
Company rating on Naukri (0-5 scale)
Number of company reviews on Naukri
Number of open positions for this job
Work from home policy (e.g., “Full Time”, “Hybrid”)
Shared Fields
Industry/sector of the company (available on LinkedIn and Indeed)
Example
Notes
- Only
titleandjob_urlare guaranteed to be present. All other fields are optional and depend on what data is available from the job board. - Site-specific fields (LinkedIn, Indeed, Naukri) are only populated when scraping from those respective sites.
- Use the
description_formatparameter inscrapeJobs()to control whether descriptions are returned as HTML, Markdown, or plain text. - The
job_url_directfield often provides a better application experience but may not always be available.
Related Types
- JobResponse - Container for multiple job posts
- Location - Geographic location structure
- Compensation - Salary/wage information
- JobType enum - Job type constants
