InsightSocial APIJob
The job posting shape returned by the LinkedIn job endpoints. A beta, long-tail shape in schema 2.
Endpoints that return job postings use this shape. On InsightSocial that means LinkedIn.
Beta in schema 2
Schema 2 types four entities: post, profile, comment and transcript. The job endpoints are long-tail: their data is the source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities, and its fields may change. The next page is in pagination.next_cursor. The fields below are what these endpoints return today. They are marked beta in the API reference and can change without a schema version, so read them defensively.
Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | No | The platform's ID for the job. |
title | string | Yes | Job title. |
url | string | Yes | Link to the posting. |
company.id | string | Yes | ID of the hiring company. |
company.name | string | Yes | Company name. |
company.url | string | Yes | Link to the company page. |
company.verified | boolean | Yes | Whether the company page is verified. |
location | string | Yes | Where the job is based. |
listed_at | string | Yes | When the job was posted, as ISO 8601 UTC. |
easy_apply | boolean | Yes | Whether the job accepts Easy Apply. |
remote | string | Yes | Remote, hybrid or on-site status. |
employment_type | string | Yes | Full-time, part-time, contract and so on. |
experience_level | string | Yes | Seniority level. |
description | string | Yes | Job description. |
apply_url | string | Yes | Where to apply. |
Extension fields (ext)
Optional extras. Treat each as possibly absent.
| Field | Type | Nullable | Description |
|---|---|---|---|
ext.is_promote | boolean | Yes | Whether the posting is promoted. |
ext.applicant_count | integer | Yes | Number of applicants shown. |
ext.skills | string[] | Yes | Skills listed on the job. |
ext.job_provider | string | Yes | Where the posting originates. |
ext.salary_min | integer | Yes | Lower end of the salary range. |
ext.salary_max | integer | Yes | Upper end of the salary range. |
ext.salary_currency | string | Yes | Salary currency. |
ext.country_code | string | Yes | Country of the job. |
ext.linkedin_company_name | string | Yes | Company name as shown on LinkedIn. |
ext.industries | string | Yes | Industries of the job. |
ext.job_function | string | Yes | Job function. |
ext.accepting_applications | boolean | Yes | Whether the job is still taking applications. |
ext.board | string | Yes | Job board the posting came from. |
Which fields LinkedIn fills
id is never null. yes means LinkedIn can fill the field (it may still be null on a given row); a blank means it never does.
| Platform | company.id | company.url | company.verified | easy_apply | experience_level | remote |
|---|---|---|---|---|---|---|
| yes | yes | yes | yes |
Returned by
/v1/linkedin/job, /v1/linkedin/company/jobs and /v1/linkedin/search/jobs. See LinkedIn.