Job Schema

A successful POST /v1/jobs/search returns { metadata, data }, where data is an array of normalized job objects. Every job follows the same shape regardless of source. Most fields are nullable - a source that doesn't supply a value yields null.

Metadata

Field	Type	Description
`total_results`	`number \| null`	Total matches. `null` unless `include_total_results` was set.
`truncated_results`	`number`	Number of jobs returned in this `data` array.
`total_companies`	`number \| null`	Total distinct companies across matches, when computed.
`truncated_companies`	`number`	Distinct companies in this page.
`next_cursor`	`string \| null`	Cursor for the next page, or `null` if there are no more results.

Identity & links

Field	Type	Description
`id`	`string \| number`	Stable JobsPipe ID - same job, same ID across sources.
`job_title`	`string`	The posting's job title.
`normalized_title`	`string \| null`	Title normalized to a canonical form.
`url`	`string \| null`	Canonical posting URL.
`final_url`	`string \| null`	Resolved apply URL after redirects.
`source_url`	`string \| null`	URL on the originating source.
`company`	`string \| null`	Hiring company name.
`company_domain`	`string \| null`	Company website domain.
`company_object`	`object \| null`	Structured company details, when available.

Dates & lifecycle

Field	Type	Description
`date_posted`	`string \| null`	Date the job was posted (`YYYY-MM-DD`).
`discovered_at`	`string \| null`	When JobsPipe first ingested the posting.
`closed_at`	`string \| null`	When the posting was detected closed.
`reposted`	`boolean`	Whether the role was reposted.
`date_reposted`	`string \| null`	Date of the most recent repost.
`has_blurred_data`	`boolean`	Whether some fields are blurred on the source.

Location

Field	Type	Description
`location`	`string \| null`	Display location string.
`short_location`	`string \| null`	Condensed location.
`long_location`	`string \| null`	Full location string.
`country`	`string \| null`	Primary country name.
`country_code`	`string \| null`	Primary ISO country code.
`countries`	`string[]`	All associated country names.
`country_codes`	`string[]`	All associated ISO country codes.
`cities`	`string[]`	Associated cities.
`continents`	`string[]`	Associated continents.
`state_code`	`string \| null`	State/region code.
`postal_code`	`string \| null`	Postal code.
`latitude`	`number \| null`	Latitude.
`longitude`	`number \| null`	Longitude.
`remote`	`boolean \| null`	Remote flag.
`hybrid`	`boolean \| null`	Hybrid flag.

Compensation

Field	Type	Description
`salary_string`	`string \| null`	Raw salary text as posted.
`salary_currency`	`string \| null`	Salary currency code.
`min_annual_salary`	`number \| null`	Minimum annual salary (original currency).
`max_annual_salary`	`number \| null`	Maximum annual salary (original currency).
`min_annual_salary_usd`	`number \| null`	Minimum annual salary in USD.
`max_annual_salary_usd`	`number \| null`	Maximum annual salary in USD.
`avg_annual_salary_usd`	`number \| null`	Average annual salary in USD.

Classification & content

Field	Type	Description
`seniority`	`string \| null`	Seniority level.
`employment_statuses`	`string[]`	Employment types, e.g. `["Full-time"]`.
`easy_apply`	`boolean \| null`	Whether the source offers one-click apply.
`technology_slugs`	`string[]`	Detected technologies referenced in the posting.
`keyword_slugs`	`string[]`	Detected keywords.
`hiring_team`	`array`	Hiring-team members, when available.
`description`	`string \| null`	Full job description.
`matching_phrases`	`string[]`	Phrases in the posting that matched your query.
`matching_words`	`string[]`	Words in the posting that matched your query.

Fields are added over time and are always additive. Treat unknown fields as forward-compatible and read only the ones you need.