{ "openapi": "3.0.1", "info": { "title": "UN Careers (United Nations) Job Scraper", "description": "Get live job openings from the United Nations careers portal (careers.un.org) as clean structured data. Filter by keyword, category, job family, network and duty station. No login, no setup.", "version": "0.1", "x-build-id": "juN2nbXON42ITccsU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nomad-dev~un-careers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nomad-dev-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-dev~un-careers-scraper/runs": { "post": { "operationId": "runs-sync-nomad-dev-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-dev~un-careers-scraper/run-sync": { "post": { "operationId": "run-sync-nomad-dev-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 (all matching openings).", "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 } } }, "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 } } } } } } } } } }