# ReliefWeb Jobs Scraper — Humanitarian & NGO (`nomad-jobs/reliefweb-scraper`) Actor Scrape live humanitarian, NGO and UN-sector vacancies from ReliefWeb (UN OCHA's portal). Each record includes title, organization, country, closing date and apply URL. Filter by keyword or country. Built for aid-sector job boards, alert bots and workforce research. - **URL**: https://apify.com/nomad-jobs/reliefweb-scraper.md - **Developed by:** [Nomad.Dev](https://apify.com/nomad-jobs) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ReliefWeb Jobs Scraper — Humanitarian & NGO Fetch current humanitarian and NGO vacancies from ReliefWeb, the UN OCHA jobs portal, as clean JSON records. ### What ReliefWeb jobs data does this scraper extract? Each result is one flat JSON record per job posting: | Field | Meaning | |---|---| | `id` | Stable source-side identifier (ReliefWeb job id) | | `title` | Job title as posted | | `company` | Hiring organisation, or `null` if not tagged | | `country` | Country as published by ReliefWeb's own Country tag, or `null` | | `location` | City + country combined for display (falls back to "Worldwide" / "Remote / Worldwide") | | `url` | Direct link to the posting | | `postedAt` | Posting date/time as published in the feed, or `null` | | `deadline` | Application closing date (ISO `YYYY-MM-DD`), or `null` if the posting has no closing date | | `snippet` | Short plain-text description excerpt | | `source` | Always `"reliefweb"` | ### How to scrape ReliefWeb jobs with this Actor 1. Click **Try for free** / **Run** — no login to the target site, no cookies, no proxies to configure. 2. Adjust the input (`search`, `country`, `postedSince`, `maxItems`) or keep the defaults. 3. Run it and export the dataset as JSON, CSV or Excel, or read it over the [API](https://docs.apify.com/api/v2). Run it from your own code: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("nomad-jobs/reliefweb-scraper").call(run_input={"maxItems": 50}) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["title"], "—", item["company"], item["url"]) ```` Or a single HTTP call that runs the Actor and returns items in one response: ```bash curl -X POST \ "https://api.apify.com/v2/acts/nomad-jobs~reliefweb-scraper/run-sync-get-dataset-items?token=" \ -H "Content-Type: application/json" \ -d '{"maxItems": 50}' ``` ### Input | Field | Type | Default | Notes | |---|---|---|---| | `search` | string | `""` | Free-text query to filter the feed (e.g. "software engineer", "data", "IT digital"). Leave empty for all current openings. | | `country` | string | `""` | Only return postings whose Country field contains this text (e.g. "Kenya"). Case-insensitive, partial match. Leave empty for all countries. | | `postedSince` | integer | `0` | Only return postings published within this many days. Set 0 to disable. | | `maxItems` | integer | `20` | Maximum number of job openings to return (capped at 20 — the feed always returns roughly the 20 most recent postings per fetch). Set 0 for no limit. Each result returned is billed. | | `proxyConfiguration` | object (proxy) | Residential group | Proxy used to fetch the feed. Keep Residential selected — ReliefWeb blocks datacenter IPs. Overrides `useResidentialProxy` when set. | | `useResidentialProxy` | boolean | `true` | **Deprecated** — use `proxyConfiguration` instead. Kept as a fallback for old callers when `proxyConfiguration` is not set. | | `cacheTtlSeconds` | integer | `1800` | *(Advanced)* Reuse a previously fetched feed for this many seconds instead of re-fetching. Set 0 to always fetch fresh data. | ### Output example ```json { "id": "4218889", "title": "Protection Officer", "company": "Danish Refugee Council", "country": "Ukraine", "location": "Ukraine", "url": "https://reliefweb.int/job/4218889/protection-officer", "postedAt": "Thu, 02 Jul 2026 12:30:09 +0000", "deadline": "2026-07-16", "snippet": "DRC is looking for a Protection Officer...", "source": "reliefweb" } ``` Any field the source doesn't provide for a given posting (e.g. no closing date, no organisation tag) comes back as `null`, never an empty string. ### Integrations Export the dataset as JSON, CSV or Excel from the Console, or pull it programmatically: works out of the box with Make, Zapier and n8n, is callable via a single `run-sync-get-dataset-items` HTTP call (see below), and is usable from AI agents through the [Apify MCP server](https://apify.com/apify/actors-mcp-server). ### Pricing Pay per event: **$0.05 per Actor start** and **$0.004 per job returned**. 100 jobs ≈ $0.45. No subscription, no rental — you pay only for what you fetch. If you keep the default Residential proxy on, Apify also bills residential proxy bandwidth (GB) separately per your plan's proxy rates. ### Use cases - Humanitarian-sector job boards and newsletters - Deadline-aware alert bots for aid workers - M\&E and surge-roster sourcing - Research on humanitarian hiring by country ### FAQ **Is it legal to scrape ReliefWeb jobs?** This Actor reads only publicly available job postings — data any visitor can see without logging in. No personal data behind authentication is touched. Review the target site's terms and your local regulations for your specific use case. **Do I need an account on the target site?** No. Postings are fetched from public pages/APIs — no login, cookies or session tokens. **How fresh is the data?** Every run fetches live listings. Results are cached for `cacheTtlSeconds` (default 30 min, set 0 to always hit the source live). **How many jobs can I get?** The ReliefWeb jobs feed returns roughly the 20 most recent postings per fetch, newest first, and does not paginate further — `maxItems` (capped at 20) trims that down if you want fewer. **Something broken or missing?** Open an issue on the Actor's **Issues** tab — it is monitored and reliability fixes ship fast. ### Related Actors - [Research & Academic Jobs Scraper — 10 Sources](https://apify.com/nomad-jobs/researcher-bundle) - [UN Careers Job Scraper — United Nations Jobs](https://apify.com/nomad-jobs/un-careers-scraper) - [Impactpool Jobs Scraper — UN & NGO Careers](https://apify.com/nomad-jobs/impactpool-scraper) - [Devex Jobs Scraper — International Development](https://apify.com/nomad-jobs/devex-scraper) # Actor input Schema ## `search` (type: `string`): Free-text query to filter the feed (e.g. "software engineer", "data", "IT digital"). Leave empty for all current openings (latest ~20 globally). ## `country` (type: `string`): Only return postings whose Country field (as published by ReliefWeb) contains this text, e.g. "Kenya" or "Yemen". Case-insensitive, partial match. Leave empty for all countries. Applied after fetching, so it never changes cost. ## `postedSince` (type: `integer`): Only return postings published within this many days. Set 0 to disable (no freshness filter). Applied after fetching using each posting's publish date, so it never changes cost. ## `maxItems` (type: `integer`): Maximum number of job openings to return. ReliefWeb's jobs feed always returns roughly the 20 most recent postings per fetch, so values above 20 have no effect. Set 0 for no limit (returns everything the feed provides). Each result returned is billed — see Pricing in the README. ## `proxyConfiguration` (type: `object`): Recommended: keep the Residential proxy group selected. ReliefWeb blocks requests from datacenter IPs, so a Residential proxy is needed for the fetch to succeed reliably. Overrides the deprecated "Use residential proxy" toggle below when set. ## `useResidentialProxy` (type: `boolean`): Deprecated — use the Proxy configuration field above instead. Kept only for backward compatibility: used as a fallback when Proxy configuration is not set, to decide whether to fetch through an Apify Residential proxy (required because ReliefWeb blocks datacenter IPs). ## `cacheTtlSeconds` (type: `integer`): Reuse a previously fetched feed for this many seconds instead of fetching again, so repeated runs within the window are faster and skip the network call. Set 0 to always fetch fresh data. ## Actor input object example ```json { "search": "software engineer", "country": "Kenya", "postedSince": 0, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "useResidentialProxy": true, "cacheTtlSeconds": 1800 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("nomad-jobs/reliefweb-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("nomad-jobs/reliefweb-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call nomad-jobs/reliefweb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nomad-jobs/reliefweb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ReliefWeb Jobs Scraper — Humanitarian & NGO", "description": "Scrape live humanitarian, NGO and UN-sector vacancies from ReliefWeb (UN OCHA's portal). Each record includes title, organization, country, closing date and apply URL. Filter by keyword or country. Built for aid-sector job boards, alert bots and workforce research.", "version": "0.1", "x-build-id": "EujvQSEdR7BneiY4R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nomad-jobs~reliefweb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nomad-jobs-reliefweb-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-jobs~reliefweb-scraper/runs": { "post": { "operationId": "runs-sync-nomad-jobs-reliefweb-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-jobs~reliefweb-scraper/run-sync": { "post": { "operationId": "run-sync-nomad-jobs-reliefweb-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": { "search": { "title": "Keyword search", "type": "string", "description": "Free-text query to filter the feed (e.g. \"software engineer\", \"data\", \"IT digital\"). Leave empty for all current openings (latest ~20 globally)." }, "country": { "title": "Country filter", "type": "string", "description": "Only return postings whose Country field (as published by ReliefWeb) contains this text, e.g. \"Kenya\" or \"Yemen\". Case-insensitive, partial match. Leave empty for all countries. Applied after fetching, so it never changes cost." }, "postedSince": { "title": "Posted within last N days", "minimum": 0, "type": "integer", "description": "Only return postings published within this many days. Set 0 to disable (no freshness filter). Applied after fetching using each posting's publish date, so it never changes cost.", "default": 0 }, "maxItems": { "title": "Max items", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum number of job openings to return. ReliefWeb's jobs feed always returns roughly the 20 most recent postings per fetch, so values above 20 have no effect. Set 0 for no limit (returns everything the feed provides). Each result returned is billed — see Pricing in the README.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Recommended: keep the Residential proxy group selected. ReliefWeb blocks requests from datacenter IPs, so a Residential proxy is needed for the fetch to succeed reliably. Overrides the deprecated \"Use residential proxy\" toggle below when set.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "useResidentialProxy": { "title": "Use residential proxy (deprecated)", "type": "boolean", "description": "Deprecated — use the Proxy configuration field above instead. Kept only for backward compatibility: used as a fallback when Proxy configuration is not set, to decide whether to fetch through an Apify Residential proxy (required because ReliefWeb blocks datacenter IPs).", "default": true }, "cacheTtlSeconds": { "title": "Cache TTL (seconds)", "minimum": 0, "type": "integer", "description": "Reuse a previously fetched feed for this many seconds instead of fetching again, so repeated runs within the window are faster and skip the network call. Set 0 to always fetch fresh data.", "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 } } } } } } } } } } ```