careers.un.org APIcareers.un.org ↗
Retrieve structured UN job listings filtered by job network and family. Get title, level, department, duty station, and direct URL for every open position.
curl -X GET 'https://api.parse.bot/scraper/38aeaefc-8ad9-426a-90d9-73be35810e3e/get_job_openings?job_networks=DEVNET&items_per_page=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all open job positions matching the specified job network and job family filters. Returns structured data for each position including title, level, department, duty station, dates, and direct URL. Automatically paginates through all matching results.
| Param | Type | Description |
|---|---|---|
| job_families | string | Comma-separated job family codes to filter by (e.g. LEG,POL,HRI,HRA). Omitting returns all families within the selected networks. |
| job_networks | string | Comma-separated job network codes to filter by. Confirmed working values: LEGALNET, POLNET, DEVNET, ITECNET, PSNET, SAFETYNET, ECONSOCNET, MGTNET, LOGNET, INFONET. |
| items_per_page | integer | Number of items per internal API page. Higher values reduce API calls. |
{
"type": "object",
"fields": {
"jobs": "array of job objects with fields: job_id, posting_title, job_title, job_code_title, job_level, category, category_code, job_network, job_network_code, job_family, job_family_code, department, duty_station, date_posted, deadline, recruitment_type, url",
"total_count": "integer - Total number of matching jobs",
"jobs_returned": "integer - Number of jobs in this response",
"filters_applied": "object - The filters that were applied, containing job_networks and job_families arrays"
},
"sample": {
"data": {
"jobs": [
{
"url": "https://careers.un.org/jobopening/275510?language=en",
"job_id": 275510,
"category": "Professional and Higher Categories",
"deadline": "2026-05-20",
"job_level": "P-4",
"job_title": "POLITICAL AFFAIRS OFFICER",
"department": "Office of Counter-Terrorism",
"job_family": "Political Affairs",
"date_posted": "2026-05-13",
"job_network": "Political, Peace and Humanitarian",
"duty_station": "NEW YORK",
"category_code": "PD",
"posting_title": "POLITICAL AFFAIRS OFFICER, P4",
"job_code_title": "POLITICAL AFFAIRS OFFICER",
"job_family_code": "POL",
"job_network_code": "POLNET",
"recruitment_type": "J"
}
],
"total_count": 27,
"jobs_returned": 27,
"filters_applied": {
"job_families": [],
"job_networks": [
"LEGALNET",
"POLNET"
]
}
},
"status": "success"
}
}About the careers.un.org API
The UN Careers API exposes one endpoint — get_job_openings — that returns all currently open positions from the United Nations careers portal, with up to 10 structured fields per job listing. You can filter results by job network codes such as LEGALNET, POLNET, DEVNET, and ITECNET, and narrow further by job family codes like LEG, POL, or HRI. The endpoint handles pagination automatically, so you receive the full result set without managing page tokens.
What the API Returns
The get_job_openings endpoint returns an array of job objects alongside three summary fields: total_count (total matching positions), jobs_returned (count in the current response), and filters_applied (the exact network and family codes used). Each job object includes job_id, posting_title, job_title, job_code_title, job_level, category, category_code, job_network, and duty station and date fields, plus a direct URL to the listing on careers.un.org.
Filtering by Network and Family
The two primary filter parameters are job_networks and job_families, both accepting comma-separated codes. job_networks accepts values including LEGALNET, POLNET, DEVNET, ITECNET, PSNET, SAFETYNET, ECONSOCNET, MGTNET, LOGNET, and INFONET. job_families accepts codes such as LEG, POL, HRI, and HRA. Omitting job_families returns all families within the specified network. Omitting both parameters returns all open positions across every network.
Pagination Behavior
The items_per_page parameter controls how many records are fetched per internal page. Setting a higher value reduces the number of round trips required to collect all results. Regardless of this setting, the endpoint automatically paginates through the full result set and returns all matching jobs in a single response — callers do not need to implement their own pagination loop.
- Build a job alert service that monitors new UN postings by job network and notifies subscribers when matching roles appear.
- Aggregate UN job listings by duty station to analyze geographic distribution of open positions.
- Filter ITECNET and DEVNET postings to track technology and development vacancies across UN departments.
- Compare job levels (job_level field) across job families to research career progression paths within the UN system.
- Feed structured UN job data into an applicant tracking or recruiting pipeline with direct listing URLs.
- Produce a dashboard showing open headcount by category_code and job_network for workforce planning research.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.