{
"openapi": "3.0.1",
"info": {
"title": "UN Careers Job Scraper — United Nations Jobs",
"description": "Get live UN Secretariat job openings from careers.un.org: title, department, duty station, level, category, job family, network, deadline and apply URL. Filter by keyword, category, job family, network, duty station, or run delta mode for only-new postings. No login, no setup.",
"version": "0.1",
"x-build-id": "Q0IFJ1GrbiesKD2wV"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/nomad-agent~un-careers-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-nomad-agent-un-careers-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/nomad-agent~un-careers-scraper/runs": {
"post": {
"operationId": "runs-sync-nomad-agent-un-careers-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/nomad-agent~un-careers-scraper/run-sync": {
"post": {
"operationId": "run-sync-nomad-agent-un-careers-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"keyword": {
"title": "Keyword",
"type": "string",
"description": "Free-text search across job titles and descriptions (e.g. data engineer, human rights). Leave empty to return all current openings."
},
"categories": {
"title": "Categories",
"type": "array",
"description": "Staff category. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"PD",
"GS",
"NPO",
"FS",
"INT",
"CON"
],
"enumTitles": [
"Professional and Higher (PD)",
"General Service and Related (GS)",
"National Professional Officers (NPO)",
"Field Service (FS)",
"Internship (INT)",
"Consultants (CON)"
]
}
},
"jobFamilies": {
"title": "Job families",
"type": "array",
"description": "Functional area. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"ADM",
"AVI",
"CIV",
"CON",
"DRU",
"ECO",
"EDU",
"ELA",
"ENG",
"ENV",
"FIN",
"FMG",
"HRA",
"HRE",
"HRI",
"HUM",
"ING",
"IST",
"LAN",
"LEG",
"LOG",
"MED",
"MGA",
"OMB",
"PAM",
"PBA",
"PGM",
"POL",
"PUB",
"ROL",
"SEC",
"SOC",
"STT",
"TEL",
"TRA"
],
"enumTitles": [
"Administration",
"Aviation",
"Civil Affairs",
"Conference Services",
"Drug Control and Crime Prevention",
"Economic Affairs",
"Education",
"Electoral Affairs",
"Engineering",
"Environmental Affairs",
"Finance",
"Facilities Management",
"Humanitarian Affairs",
"Human Resources",
"Human Rights Affairs",
"Human Settlements",
"Investigation",
"Information Management Systems and Technology",
"Language",
"Legal Affairs",
"Logistics and Supply Chain",
"Medical",
"Management and Analysis",
"Ombudsman",
"Property and Asset Management",
"Public Administration",
"Programme Management",
"Political Affairs",
"Public Information",
"Rule of Law",
"Security",
"Social Affairs",
"Statistics",
"Telecommunications Technology",
"Transportation"
]
}
},
"networks": {
"title": "Job networks",
"type": "array",
"description": "High-level job network. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"DEVNET",
"INFONET",
"ITECNET",
"LEGALNET",
"LOGNET",
"MAGNET",
"POLNET",
"SAFETYNET",
"SCINET"
],
"enumTitles": [
"Economic, Social and Development",
"Public Information and Conference Management",
"Information and Telecommunication Technology",
"Legal",
"Logistics, Transportation and Supply Chain",
"Management and Administration",
"Political, Peace and Humanitarian",
"Internal Security and Safety",
"Science"
]
}
},
"locationFilter": {
"title": "Duty station filter",
"type": "string",
"description": "Optional case-insensitive substring match on duty station, applied client-side (the API has no server-side location filter). E.g. geneva, new york, nairobi."
},
"maxItems": {
"title": "Max items",
"minimum": 0,
"type": "integer",
"description": "Maximum number of openings to return. Set 0 for no limit — returns every matching opening. careers.un.org carries roughly 480 vacancies in total, so at $0.006 per result an uncapped run costs about $3 and finishes in under a minute.",
"default": 100
},
"includeDescription": {
"title": "Include full description",
"type": "boolean",
"description": "Include the full plain-text job description in each result. Turn off for lighter, faster output.",
"default": true
},
"sortDirection": {
"title": "Sort by start date",
"enum": [
"newest",
"oldest"
],
"type": "string",
"description": "Order openings by posting start date.",
"default": "newest"
},
"cacheTtlSeconds": {
"title": "Cache TTL (seconds)",
"minimum": 0,
"type": "integer",
"description": "Cache the upstream fetch in the key-value store for this many seconds; re-runs within the window skip the network call. Set 0 to disable.",
"default": 1800
},
"onlyNewSinceLastRun": {
"title": "Only new since last run",
"type": "boolean",
"description": "Delta / monitoring mode: only output openings not seen on a previous run that also had this flag on. Already-seen postings are dropped before push (never billed), so this is the cheapest way to run this Actor on a schedule and only pay for genuinely new UN vacancies. State is tracked per Actor in a dedicated key-value store, keyed by each posting's jobId. The first delta run has nothing to compare against, so it emits everything. See README “Delta mode / monitoring”.",
"default": false
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}