# Devex Jobs Scraper — International Development (`nomad-agent/devex-scraper`) Actor Extract international-development vacancies from Devex.com — donor-funded programmes, consultancies, INGO and multilateral roles. An AI step (bring your own Anthropic key) reads listing pages into clean records: title, organisation, location, deadline, URL. - **URL**: https://apify.com/nomad-agent/devex-scraper.md - **Developed by:** [Nomad.Dev](https://apify.com/nomad-agent) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 0.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 ## Devex Jobs Scraper — International Development Fetch international development vacancies from Devex, parsed by an AI extraction step (BYO Anthropic or Mistral key). > **Bring your own key.** This Actor uses either Claude (Anthropic) or Mistral for AI discovery/extraction — pick with `provider`. Pass `anthropicApiKey` (provider `"anthropic"`, default) or `mistralApiKey` (provider `"mistral"`) in the input. Without a matching key the run fails immediately with a clear error message. ### AI provider: Anthropic vs Mistral `provider` selects which AI does discovery + extraction: - **`anthropic`** (default) — a Claude agent uses Anthropic's built-in web-search tool to search Devex via Google site-search and extract structured listings from the same tool loop. - **`mistral`** — since Mistral has no built-in web-search tool, this path uses [keenable](https://keenable.ai) (no-auth web search) to run the same Google site-searches, then ONE Mistral call extracts structured fields from the combined candidate list (title/URL/snippet — Devex blocks direct page fetches for both providers, so both work from search-result metadata only, never a page fetch). Pick whichever provider you'd rather bring a key for; output shape and the no-guessing extraction rules (never fabricate `postedAt`/`deadline`, extract `company` from explicit signals only) are identical either way. ### What Devex jobs data does this scraper extract? Each result is one flat JSON record per job posting: | Field | Meaning | |---|---| | `source` | Always `"devex"` | | `id` | Stable source-side identifier (job id parsed from the posting URL) | | `title` | Job title as posted | | `company` | Hiring company / organisation | | `location` | Location / duty station text from the search snippet (may be empty) | | `url` | Direct link to the posting | | `postedAt` | Posting date (`YYYY-MM-DD`), only when explicitly stated on the page or search snippet — `null` when unknown. Devex postings are discovered via Google search results, which frequently omit a reliable date, so `null` is common and expected; the actor never guesses or fabricates a date. | | `deadline` | Application closing date (`YYYY-MM-DD`), only when explicitly stated — `null` when not stated. Also commonly `null`. | | `snippet` | Short description excerpt from the search result | `externalId` is also present on every record, duplicating `id` — it is a deprecated alias kept for backward compatibility with existing integrations and will be removed in a future major version. ### How to scrape Devex 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 (keyword, filters, `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-agent/devex-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-agent~devex-scraper/run-sync-get-dataset-items?token=" \ -H "Content-Type: application/json" \ -d '{"maxItems": 50}' ``` ### Integrations Export the dataset as JSON, CSV or Excel from the Apify Console, pull it over the [API](https://docs.apify.com/api/v2) (including `run-sync-get-dataset-items` for a single-call run), wire it into Make/Zapier/n8n, or call this Actor as a tool from an AI agent via the [Apify MCP server](https://apify.com/apify/actors-mcp-server). ### Input | Field | Type | Default | Notes | |---|---|---|---| | `provider` | string | `"anthropic"` | Which AI provider runs discovery + extraction: `"anthropic"` (Claude + built-in web search) or `"mistral"` (keenable web search + Mistral extraction). | | `anthropicApiKey` | string | — | Your Anthropic API key (sk-ant-...). Required when `provider` is `"anthropic"` — your key is billed directly by Anthropic for that usage (separate from Apify's pricing). Keep this secret. | | `mistralApiKey` | string | — | Your Mistral API key. Required when `provider` is `"mistral"` — used only for extraction (search itself goes through keenable, no key needed). Billed directly by Mistral, separate from Apify's pricing. Keep this secret. | | `mistralModel` *(Advanced)* | string | `"mistral-small-latest"` | Mistral model for extraction (provider `"mistral"` only): `mistral-small-latest` (default — matches larger models on this small, well-scoped task), `mistral-medium-latest`, or `mistral-large-latest`. | | `keyword` | string | `""` | Topic or role keyword to focus the search (e.g. "monitoring evaluation", "migration", "policy analyst"). Leave empty to surface a broad mix of international-development postings. | | `location` | string | `""` | Geographic filter passed to the search (e.g. "Geneva", "remote", "Africa"). Leave empty for worldwide listings. | | `maxItems` | integer | `12` | Maximum number of job postings to return (1–50). Each result is billed under this Actor's pay-per-result pricing; the Claude API calls behind every run are ALSO billed separately by Anthropic to your own account, regardless of this cap. | | `model` *(Advanced)* | string | `"claude-haiku-4-5-20251001"` | Anthropic model to use for job discovery. Must support the web\_search\_20250305 built-in tool (Claude 3.5 Sonnet or later recommended). The default works well for almost everyone. | ### Output example `postedAt` and `deadline` are `null` unless Devex's search results genuinely state a date — that's the honest common case, not a bug: ```json { "source": "devex", "id": "889021", "externalId": "889021", "title": "Chief of Party — USAID Health", "company": "Chemonics", "location": "Nairobi, Kenya", "url": "https://www.devex.com/jobs/chief-of-party-889021", "postedAt": null, "deadline": null, "snippet": "Chemonics seeks a Chief of Party..." } ``` When a date is stated on the page or in the search snippet, `postedAt` / `deadline` are populated as `"YYYY-MM-DD"` strings instead of `null`. ### 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. **This is a "bring your own key" (BYOK) Actor.** Every run calls the AI provider you pick (`provider`) using the `anthropicApiKey` or `mistralApiKey` you supply, and that usage is billed to **your own Anthropic or Mistral account, separately from Apify's pricing above**. Apify's PPE charges only cover the Actor's own run/result events — they do not include Anthropic's or Mistral's token costs. Check [Anthropic's pricing](https://www.anthropic.com/pricing) or [Mistral's pricing](https://mistral.ai/pricing) for the model you configure. ### Use cases - Development-sector job boards - Proposal/recruitment teams tracking donor-funded roles - Consultant roster building - Aid-sector hiring analysis ### FAQ **Is it legal to scrape Devex 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 performs live Claude web searches against Devex's Google-indexed listings at run time — there is no caching layer, so each run reflects whatever is currently indexed. **How many jobs can I get?** `maxItems` caps the run at 1–50 postings. **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-agent/researcher-bundle) - [UN Careers Job Scraper — United Nations Jobs](https://apify.com/nomad-agent/un-careers-scraper) - [ReliefWeb Jobs Scraper — Humanitarian & NGO](https://apify.com/nomad-agent/reliefweb-scraper) - [Impactpool Jobs Scraper — UN & NGO Careers](https://apify.com/nomad-agent/impactpool-scraper) # Actor input Schema ## `provider` (type: `string`): Which AI provider runs discovery + extraction. "anthropic" (default) uses a Claude agent with Anthropic's built-in web-search tool. "mistral" uses keenable (no-auth web search) for discovery plus a Mistral model to extract structured fields from the search results -- pick this if you'd rather bring a Mistral key than an Anthropic one. ## `anthropicApiKey` (type: `string`): Your Anthropic API key (sk-ant-...). Required when provider is "anthropic" — the actor uses Claude with web search to discover DevEx listings, and your key is billed directly by Anthropic for that usage (separate from Apify's pricing). Keep this secret. ## `mistralApiKey` (type: `string`): Your Mistral API key. Required when provider is "mistral". Used only for extraction from search results -- the web search itself goes through keenable, which needs no key. Billed directly by Mistral for that usage (separate from Apify's pricing). Keep this secret. ## `mistralModel` (type: `string`): Mistral model for extraction (provider="mistral" only). Small is the default -- testing found it matches larger Mistral models on this task (extraction is small and well-scoped: title/company/location/dates from a search snippet) at a fraction of the cost. ## `keyword` (type: `string`): Topic or role keyword to focus the search (e.g. "monitoring evaluation", "migration", "policy analyst"). Leave empty to surface a broad mix of international-development postings. ## `location` (type: `string`): Geographic filter passed to the search (e.g. "Geneva", "remote", "Africa"). Leave empty for worldwide listings. ## `maxItems` (type: `integer`): Maximum number of job postings to return (1–50). Each result is billed under this Actor's pay-per-result pricing; the Claude API calls behind every run are ALSO billed separately by Anthropic to your own account, regardless of this cap. ## `model` (type: `string`): Anthropic model to use for job discovery. Must support the web\_search\_20250305 built-in tool (Claude 3.5 Sonnet or later recommended). Advanced setting — the default works well for almost everyone. ## Actor input object example ```json { "provider": "anthropic", "mistralModel": "mistral-small-latest", "keyword": "research officer", "location": "Geneva", "maxItems": 12, "model": "claude-haiku-4-5-20251001" } ``` # 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-agent/devex-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-agent/devex-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-agent/devex-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nomad-agent/devex-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Devex Jobs Scraper — International Development", "description": "Extract international-development vacancies from Devex.com — donor-funded programmes, consultancies, INGO and multilateral roles. An AI step (bring your own Anthropic key) reads listing pages into clean records: title, organisation, location, deadline, URL.", "version": "0.1", "x-build-id": "d4eEmmWahY8lIKELp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nomad-agent~devex-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nomad-agent-devex-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~devex-scraper/runs": { "post": { "operationId": "runs-sync-nomad-agent-devex-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~devex-scraper/run-sync": { "post": { "operationId": "run-sync-nomad-agent-devex-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": { "provider": { "title": "AI provider", "enum": [ "anthropic", "mistral" ], "type": "string", "description": "Which AI provider runs discovery + extraction. \"anthropic\" (default) uses a Claude agent with Anthropic's built-in web-search tool. \"mistral\" uses keenable (no-auth web search) for discovery plus a Mistral model to extract structured fields from the search results -- pick this if you'd rather bring a Mistral key than an Anthropic one.", "default": "anthropic" }, "anthropicApiKey": { "title": "Anthropic API Key", "type": "string", "description": "Your Anthropic API key (sk-ant-...). Required when provider is \"anthropic\" — the actor uses Claude with web search to discover DevEx listings, and your key is billed directly by Anthropic for that usage (separate from Apify's pricing). Keep this secret." }, "mistralApiKey": { "title": "Mistral API key", "type": "string", "description": "Your Mistral API key. Required when provider is \"mistral\". Used only for extraction from search results -- the web search itself goes through keenable, which needs no key. Billed directly by Mistral for that usage (separate from Apify's pricing). Keep this secret." }, "mistralModel": { "title": "Mistral model", "enum": [ "mistral-small-latest", "mistral-medium-latest", "mistral-large-latest" ], "type": "string", "description": "Mistral model for extraction (provider=\"mistral\" only). Small is the default -- testing found it matches larger Mistral models on this task (extraction is small and well-scoped: title/company/location/dates from a search snippet) at a fraction of the cost.", "default": "mistral-small-latest" }, "keyword": { "title": "Keyword / topic", "type": "string", "description": "Topic or role keyword to focus the search (e.g. \"monitoring evaluation\", \"migration\", \"policy analyst\"). Leave empty to surface a broad mix of international-development postings." }, "location": { "title": "Location", "type": "string", "description": "Geographic filter passed to the search (e.g. \"Geneva\", \"remote\", \"Africa\"). Leave empty for worldwide listings." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of job postings to return (1–50). Each result is billed under this Actor's pay-per-result pricing; the Claude API calls behind every run are ALSO billed separately by Anthropic to your own account, regardless of this cap.", "default": 12 }, "model": { "title": "Claude model", "type": "string", "description": "Anthropic model to use for job discovery. Must support the web_search_20250305 built-in tool (Claude 3.5 Sonnet or later recommended). Advanced setting — the default works well for almost everyone.", "default": "claude-haiku-4-5-20251001" } } }, "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 } } } } } } } } } } ```