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
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.
| Field | Type | Description |
|---|---|---|
title, standardized_title | string | Title as written, and the normalized title for grouping similar roles. |
description, description_html | string | Full description as plain text and as HTML. |
location, country_code | string | Location as written and its two-letter country code. |
workplace_types | array | ONSITE, REMOTE or HYBRID. |
employment_status | string | null | Full-time, Part-time, Contract, Internship and so on. |
experience_level | string | null | Seniority, from Internship to Executive. |
job_functions, industries | array | Functions and industries the posting is filed under. |
salary, salary_min, salary_max | string | number | null | Pay range, when the employer published one. Most do not. |
listed_at, closed_at | string | null | When the posting went live, and when it stopped taking applications. |
job_state | string | null | LISTED while open, CLOSED once it stops. |
total_applies, total_views | integer | null | Applications received and views. |
company_info | object | Hiring 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
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
Get your API key
1 minPOST a job id or URL
1 minUse the posting data
Instant