JOB DETAILS API

Any Job Posting as Structured JSON

Send a job id or URL and get the full posting: title, description as text and HTML, location, seniority, employment and workplace type, salary when published, apply counts and the hiring company.

POST/api/v1/jobs/detail

{
  "data": {
    "title": "Generative AI Engineer",
    "location": "Noida, Uttar Pradesh, India",
    "employment_status": "Full-time",
    "experience_level": "Associate",
    "company_info": { "name": "HCLTech", ... }
  }
}

What is the Datamagnet Job Details API?

The Datamagnet Job Details API turns a job posting id or URL into structured JSON. It returns the title, the description as plain text and HTML, location, seniority, employment and workplace type, salary when the employer publishes one, timing, apply and view counts, the apply link, and the hiring company. Every response carries the same keys, with null for anything the posting leaves out.

Input
Job id or job URL
Cost
1 credit per job
Freshness
Live at request time

One request

Authenticate with your API key as a bearer token and send a JSON body. This is the request behind the sample response.

  • POST /api/v1/jobs/detail
  • Input: Job id or job URL
  • Cost: 1 credit per job
POST /api/v1/jobs/detail
curl -X POST \
  "https://api.datamagnet.co/api/v1/jobs/detail" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "4443378596"}'

→ 200 OK · 1 credit

{  "success": true,  "data": {    "title": "Generative AI Engineer",    "location": "Noida, Uttar Pradesh, India",    "employment_status": "Full-time",    "experience_level": "Associate",    "workplace_types": ["ONSITE"],    "listed_at": "2026-07-21T13:36:54Z",    "job_state": "LISTED",    "salary": null,    "application_url": "https://www.linkedin.com/job-apply/4443378596",    "company_info": { "name": "HCLTech", "staff_count": 257915, ... }  },  "credit_used": 1,  "credit_addon": 0}

What you get

The main fields in the response. The Job Details reference documents every field.

FieldTypeDescription
title, standardized_titlestringTitle as written, and the normalized title for grouping similar roles.
description, description_htmlstringFull description as plain text and as HTML.
location, country_codestringLocation as written and its two-letter country code.
workplace_typesarrayONSITE, REMOTE or HYBRID.
employment_statusstring | nullFull-time, Part-time, Contract, Internship and so on.
experience_levelstring | nullSeniority, from Internship to Executive.
job_functions, industriesarrayFunctions and industries the posting is filed under.
salary, salary_min, salary_maxstring | number | nullPay range, when the employer published one. Most do not.
listed_at, closed_atstring | nullWhen the posting went live, and when it stopped taking applications.
job_statestring | nullLISTED while open, CLOSED once it stops.
total_applies, total_viewsinteger | nullApplications received and views.
company_infoobjectHiring company: name, page URL, size, industries, headquarters, followers.

Use cases

Read hiring signals

The function, seniority and location of the roles an account posts show where it is investing, for account research and timing.

Feed a job board or dataset

Every response has the same keys, with description_html ready to render and null for anything a posting leaves out, so parsing never has to branch.

Reach the hiring team

Set include_hiring_team to get the job poster and recruiters listed on the posting, with name, headline and profile link.

Frequently asked questions

1 credit per successful request. include_hiring_team adds 1 credit, charged only when the hiring team section is returned. Failed requests (4xx and 5xx) are never charged.

Either the numeric job_id or any job URL: the /jobs/view/ link, with or without the title in it, or a search URL with currentJobId. If you send both, job_id wins. The endpoint also accepts GET with the same attributes as query parameters.

When the employer published a pay range, yes: salary as displayed, plus salary_min, salary_max, salary_currency and salary_period. Most postings do not publish one, and those fields are then null.

With include_hiring_team set to true, hiring_team lists the job poster and any recruiters on the posting, with name, headline, role, profile URL and photo. A posting with nobody listed returns an empty members array.

Pull your first job postings with 10 free credits

No credit card required. Get an API key and turn a job URL into JSON in a few minutes.

  • 1 credit per job
  • Failed requests never charged
  • Same keys on every response

Interactive Demo

~15 minutes

1

Get your API key

1 min
2

POST a job id or URL

1 min
3

Use the posting data

Instant