# Research & Academic Jobs Scraper — 10 Sources (`nomad-agent/researcher-bundle`) Actor

Every researcher-relevant job source behind one endpoint: LinkedIn, EURAXESS, jobs.ac.uk, UN Careers, ReliefWeb, Impactpool, Ikerbasque, Devex, University of Copenhagen and Universitat de Barcelona. One run returns a merged, deduped dataset of live research, academic, policy and NGO roles.

- **URL**: https://apify.com/nomad-agent/researcher-bundle.md
- **Developed by:** [Nomad.Dev](https://apify.com/nomad-agent) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## 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

## Research & Academic Jobs Scraper — 10 Sources

One call, ten sources. Fans out to 10 actors covering academia, UN/NGO and policy hiring, merges and dedupes into one dataset.

> **Two sources need your own Anthropic or Mistral key.** `devex` and `ub_doctoral` extract listings using an AI provider (Claude/Anthropic or Mistral). Pass `anthropicApiKey` or `mistralApiKey` in the input to include them — either key is enough; Anthropic is preferred when both are set. Without either key, those two sources are skipped — you are not charged for them — the other 8 sources run normally, and the output includes a warning row for each skipped source (see [BYOK behavior](#byok-behavior-devex--ub-doctoral) below).

### What research jobs data does this scraper extract?

Each result is one flat JSON record per job posting:

| Field | Type | Meaning |
|---|---|---|
| `source` | string | Which child board the record came from, e.g. `"reliefweb"` |
| `id` | string | Stable source-side identifier (`""` when the source has none) |
| `title` | string | Job title as posted |
| `company` | string | Hiring company / organisation |
| `location` | string | Location / duty station (may include remote hints) |
| `url` | string | Direct link to the posting |
| `postedAt` | string | Posting date where the source provides it, else `""` |
| `deadline` | string | Application deadline where the source provides it, else `""` — populated by `euraxess`, `jobs_ac_uk`, `un_careers`, `reliefweb`, `devex`, `math_ku_phd` and `ub_doctoral`; `linkedin`, `impactpool` and `ikerbasque` don't expose a deadline, so those always return `""` |
| `snippet` | string | Short description excerpt |
| `salary` | string | Salary text where the source provides it, else `""` — only `jobs_ac_uk` populates this today; the other 9 sources always return `""` |

Warning rows (see below) additionally carry a `warning` field and every other field is `null` instead of `""`.

### How the bundle works

This is a **bundle Actor**: one endpoint that fans out to the individual job-source Actors listed below, runs them concurrently, maps every record onto one flat schema and **dedupes by URL** across boards. You can restrict the run to a subset with the `sources` input. Each child source is charged its own pay-per-event pricing on top of this bundle's — that is the cost of one-call breadth.

#### BYOK behavior (Devex & UB doctoral)

`devex` and `ub_doctoral` read listings that need extra rendering and use an AI provider (Anthropic or Mistral) to extract structured data from them, so they require `anthropicApiKey` or `mistralApiKey` — either one is enough; when both are set, Anthropic is used and `mistralApiKey`/`mistralModel` are ignored for these two sources. If you don't pass either:

- Both sources are removed from the run before any child actor is started — you are **not** billed their $0.05 actor-start fee.
- One warning row per skipped source is pushed to the dataset: `{"source": "devex", "warning": "skipped: requires anthropicApiKey or mistralApiKey", ...other fields null...}`.
- The run's status message (visible in the Apify Console and via the Runs API) also states which sources were skipped and why.
- This applies even if you explicitly list `devex` or `ub_doctoral` in `sources` — without a key they still can't produce rows, so they're still skipped and still get a warning row.
- The other 8 sources are completely unaffected.

Your Anthropic or Mistral usage for these two sources is billed separately, directly by that provider — it is not part of this Actor's Apify pricing.

### How to scrape research 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("<YOUR_APIFY_TOKEN>")
run = client.actor("nomad-agent/researcher-bundle").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~researcher-bundle/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"maxItems": 50}'
```

### Input

| Field | Type | Default | Notes |
|---|---|---|---|
| `sources` | array | `["linkedin", "euraxess", "jobs_ac_uk", "un_careers", "reliefweb", "impactpool", "ikerbasque", "devex", "math_ku_phd", "ub_doctoral"]` | Which boards to include. Leave empty to run the full default set. Each enabled source costs its own $0.05 actor-start plus per-result fees. |
| `keyword` | string | `""` | Optional free-text filter forwarded to children that support it (others ignore it). |
| `anthropicApiKey` | string (secret) | `""` | Needed (or `mistralApiKey`, below — either is enough) only for `devex` and `ub_doctoral`. Without either, those two are skipped with a warning row — see [BYOK behavior](#byok-behavior-devex--ub-doctoral). Billed separately by Anthropic. Preferred over `mistralApiKey` when both are set. |
| `mistralApiKey` | string (secret) | `""` | Alternative to `anthropicApiKey` for `devex` and `ub_doctoral` — pass this instead if you'd rather bring a Mistral key. Billed separately by Mistral. |
| `mistralModel` | string | `"mistral-small-latest"` | Mistral model forwarded to `devex`/`ub_doctoral` when they run on `mistralApiKey` (no `anthropicApiKey` supplied). |
| `maxItemsPerSource` | integer | `36` | Cap on items fetched from EACH child board before merge. |
| `maxItems` | integer | `360` | Hard cap on the merged, deduped output. Default is sources × `maxItemsPerSource` (the zero-config ceiling). Set `0` for no cap. |
| `cacheTtlSeconds` | integer | `1800` | How long to reuse results already fetched from a source instead of re-fetching. `0` = always fetch fresh. |
| `concurrency` | integer | `6` | How many child boards to run in parallel. *(Advanced)* |
| `runTimeoutSecs` | integer | `120` | How long to wait for each source before giving up on it. *(Advanced)* |
| `apifyToken` | string (secret) | `""` | Leave empty — injected automatically on the Apify platform. Only set for local runs outside the platform. *(Advanced)* |
| `actorOwner` | string | `""` | Which Apify account's child actors to call. Leave empty to use this bundle's published sources. *(Advanced)* |

### Output example

A normal record:

```json
{
  "source": "reliefweb",
  "id": "4218889",
  "title": "Protection Officer",
  "company": "Danish Refugee Council",
  "location": "Ukraine",
  "url": "https://reliefweb.int/job/4218889/protection-officer",
  "postedAt": "2026-06-28",
  "deadline": "",
  "snippet": "The Protection Officer supports...",
  "salary": ""
}
```

A source populating deadline (`euraxess`, `jobs_ac_uk`, `un_careers`, `reliefweb`, `devex`, `math_ku_phd`, `ub_doctoral`) or salary (`jobs_ac_uk` only) fills in that field instead of `""`. A warning row, pushed when a BYOK source is skipped:

```json
{
  "source": "devex",
  "id": null,
  "title": null,
  "company": null,
  "location": null,
  "url": null,
  "postedAt": null,
  "deadline": null,
  "snippet": null,
  "salary": null,
  "warning": "skipped: requires anthropicApiKey or mistralApiKey"
}
```

### Pricing

Pay per event: **$0.05 per Actor start** and **$0.004 per job returned** — plus each enabled child source's own pay-per-event pricing (also $0.05 per start + $0.004 per result, charged by that child actor directly).

Zero-config run estimate (defaults, no `anthropicApiKey`/`mistralApiKey`): 8 runnable sources × up to 36 items = up to ~288 merged items, roughly **$2.75 all-in** ($0.05 + 8×$0.05 in child starts + up to 288 items × $0.008 combined per-result fee). Pass an `anthropicApiKey` (or `mistralApiKey`) to also run `devex` and `ub_doctoral`: 10 sources × up to 36 items = up to ~360 items, roughly **$3.43 all-in**. Real runs usually cost less — not every board returns the full cap, and cross-board duplicates are billed once by whichever child returned them first but not double-billed by the bundle.

Skipped BYOK sources (neither key provided) cost nothing — no child actor-start, no per-result fees, and the warning row itself is not billed. Your own Anthropic or Mistral API usage (when you supply a key) is billed separately, directly by that provider.

### Use cases

- Academic job boards and PhD/postdoc alert bots
- NGO/policy career services
- Research-mobility analytics
- University career offices

### FAQ

**Is it legal to scrape research 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?**
`maxItems` caps the run (set 0 for no cap). Most sources paginate from newest to oldest.

**Why don't I see Devex or UB doctoral jobs?**
You didn't pass `anthropicApiKey` or `mistralApiKey` — see [BYOK behavior](#byok-behavior-devex--ub-doctoral) above. Add either key to include those two sources.

**Something broken or missing?**
Open an issue on the Actor's **Issues** tab — it is monitored and reliability fixes ship fast.

### Integrations

Export the dataset as JSON, CSV or Excel, or read it straight from the [Apify API](https://docs.apify.com/api/v2). Works out of the box with Make, Zapier and n8n via their Apify integrations, can be called synchronously with `run-sync-get-dataset-items` from any backend, and is usable by AI agents through the [Apify MCP server](https://mcp.apify.com/).

### Related Actors

- [LinkedIn Jobs Scraper — No Login, No Cookies](https://apify.com/nomad-agent/linkedin-scraper)
- [EURAXESS Jobs Scraper — EU Research Positions](https://apify.com/nomad-agent/euraxess-scraper)
- [jobs.ac.uk Scraper — UK Academic & Research Jobs](https://apify.com/nomad-agent/jobs-ac-uk-scraper)
- [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)
- [Ikerbasque Jobs Scraper — Basque Research Roles](https://apify.com/nomad-agent/ikerbasque-scraper)
- [Devex Jobs Scraper — International Development](https://apify.com/nomad-agent/devex-scraper)
- [University of Copenhagen PhD Jobs Scraper (KU)](https://apify.com/nomad-agent/math-ku-phd-scraper)
- [Universitat de Barcelona PhD Vacancy Scraper](https://apify.com/nomad-agent/ub-doctoral-scraper)

# Actor input Schema

## `sources` (type: `array`):

Which boards to include. Leave empty to run the full default set. Each enabled source starts its own child actor — $0.05 per source, plus that child's own per-result fee — on top of this bundle's fees, so fewer sources means lower cost. 'Devex' and 'UB doctoral' also need the Anthropic or Mistral API key below (either one); without either they're skipped and a warning row explaining why is added to the results.

## `keyword` (type: `string`):

Optional free-text filter forwarded to children that support it (others ignore it).

## `anthropicApiKey` (type: `string`):

Required (together with mistralApiKey, below — either one is enough) only by 'Devex' and 'UB doctoral' — they read listings that sit behind extra rendering and use an AI provider to extract them. Without either key those two sources are skipped (you are not charged for them) and a warning row is added to the output explaining why; the other 8 sources run normally either way. Usage is billed separately by Anthropic, not by this Actor.

## `mistralApiKey` (type: `string`):

Alternative to anthropicApiKey for 'Devex' and 'UB doctoral' — pass this instead if you'd rather bring a Mistral key than an Anthropic one (either key is enough; anthropicApiKey is preferred when both are set). Without either key those two sources are skipped and a warning row is added explaining why. Usage is billed separately by Mistral, not by this Actor.

## `mistralModel` (type: `string`):

Mistral model forwarded to 'Devex' and 'UB doctoral' when they run on mistralApiKey (no anthropicApiKey supplied). Small is the default — matches larger Mistral models on this task at a fraction of the cost.

## `maxItemsPerSource` (type: `integer`):

Cap on items fetched from EACH child board before merging. Cost driver: every item a child returns is billed by that child (its own per-result fee) as well as by this bundle once it survives deduping — raise with that in mind.

## `maxItems` (type: `integer`):

Hard cap on the merged, deduped output. Default (360) is sources × 'Max items per source' — the natural zero-config ceiling. A default no-key run touches 8 runnable sources: up to ~288 items, about $2.75 all-in. With an Anthropic key all 10 sources run: up to ~360 items, about $3.43 all-in. Set 0 to remove the cap — cost then scales with every source's raw output.

## `cacheTtlSeconds` (type: `integer`):

How long to reuse results already fetched from a source instead of fetching again. Set 0 to always fetch fresh data.

## `concurrency` (type: `integer`):

How many source boards to fetch at the same time.

## `runTimeoutSecs` (type: `integer`):

How long to wait for each source before giving up on it.

## `apifyToken` (type: `string`):

Leave empty — injected automatically when this Actor runs on the Apify platform. Only set this when running the code outside the platform, e.g. on your own machine.

## `actorOwner` (type: `string`):

Which Apify account's child actors this bundle calls, e.g. 'nomad-agent'. Leave empty to use the published sources this bundle ships with — only set this if you run your own fork of the child actors under a different Apify account.

## Actor input object example

```json
{
  "sources": [
    "linkedin",
    "euraxess",
    "jobs_ac_uk",
    "un_careers",
    "reliefweb",
    "impactpool",
    "ikerbasque",
    "devex",
    "math_ku_phd",
    "ub_doctoral"
  ],
  "mistralModel": "mistral-small-latest",
  "maxItemsPerSource": 36,
  "maxItems": 360,
  "cacheTtlSeconds": 1800,
  "concurrency": 6,
  "runTimeoutSecs": 120,
  "actorOwner": ""
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("nomad-agent/researcher-bundle").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("nomad-agent/researcher-bundle").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/researcher-bundle --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nomad-agent/researcher-bundle",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Research & Academic Jobs Scraper — 10 Sources",
        "description": "Every researcher-relevant job source behind one endpoint: LinkedIn, EURAXESS, jobs.ac.uk, UN Careers, ReliefWeb, Impactpool, Ikerbasque, Devex, University of Copenhagen and Universitat de Barcelona. One run returns a merged, deduped dataset of live research, academic, policy and NGO roles.",
        "version": "0.1",
        "x-build-id": "fm7HDgo1oJPOCOJgd"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nomad-agent~researcher-bundle/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nomad-agent-researcher-bundle",
                "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~researcher-bundle/runs": {
            "post": {
                "operationId": "runs-sync-nomad-agent-researcher-bundle",
                "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~researcher-bundle/run-sync": {
            "post": {
                "operationId": "run-sync-nomad-agent-researcher-bundle",
                "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": {
                    "sources": {
                        "title": "Sources",
                        "type": "array",
                        "description": "Which boards to include. Leave empty to run the full default set. Each enabled source starts its own child actor — $0.05 per source, plus that child's own per-result fee — on top of this bundle's fees, so fewer sources means lower cost. 'Devex' and 'UB doctoral' also need the Anthropic or Mistral API key below (either one); without either they're skipped and a warning row explaining why is added to the results.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "linkedin",
                                "euraxess",
                                "jobs_ac_uk",
                                "un_careers",
                                "reliefweb",
                                "impactpool",
                                "ikerbasque",
                                "devex",
                                "math_ku_phd",
                                "ub_doctoral"
                            ]
                        },
                        "default": [
                            "linkedin",
                            "euraxess",
                            "jobs_ac_uk",
                            "un_careers",
                            "reliefweb",
                            "impactpool",
                            "ikerbasque",
                            "devex",
                            "math_ku_phd",
                            "ub_doctoral"
                        ]
                    },
                    "keyword": {
                        "title": "Keyword",
                        "type": "string",
                        "description": "Optional free-text filter forwarded to children that support it (others ignore it)."
                    },
                    "anthropicApiKey": {
                        "title": "Anthropic API key (needed for 2 of 10 sources)",
                        "type": "string",
                        "description": "Required (together with mistralApiKey, below — either one is enough) only by 'Devex' and 'UB doctoral' — they read listings that sit behind extra rendering and use an AI provider to extract them. Without either key those two sources are skipped (you are not charged for them) and a warning row is added to the output explaining why; the other 8 sources run normally either way. Usage is billed separately by Anthropic, not by this Actor."
                    },
                    "mistralApiKey": {
                        "title": "Mistral API key (alternative to Anthropic, for 2 of 10 sources)",
                        "type": "string",
                        "description": "Alternative to anthropicApiKey for 'Devex' and 'UB doctoral' — pass this instead if you'd rather bring a Mistral key than an Anthropic one (either key is enough; anthropicApiKey is preferred when both are set). Without either key those two sources are skipped and a warning row is added explaining why. Usage is billed separately by Mistral, not by this Actor."
                    },
                    "mistralModel": {
                        "title": "Mistral model (only used when mistralApiKey is the key in effect)",
                        "enum": [
                            "mistral-small-latest",
                            "mistral-medium-latest",
                            "mistral-large-latest"
                        ],
                        "type": "string",
                        "description": "Mistral model forwarded to 'Devex' and 'UB doctoral' when they run on mistralApiKey (no anthropicApiKey supplied). Small is the default — matches larger Mistral models on this task at a fraction of the cost.",
                        "default": "mistral-small-latest"
                    },
                    "maxItemsPerSource": {
                        "title": "Max items per source",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Cap on items fetched from EACH child board before merging. Cost driver: every item a child returns is billed by that child (its own per-result fee) as well as by this bundle once it survives deduping — raise with that in mind.",
                        "default": 36
                    },
                    "maxItems": {
                        "title": "Max items (total)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Hard cap on the merged, deduped output. Default (360) is sources × 'Max items per source' — the natural zero-config ceiling. A default no-key run touches 8 runnable sources: up to ~288 items, about $2.75 all-in. With an Anthropic key all 10 sources run: up to ~360 items, about $3.43 all-in. Set 0 to remove the cap — cost then scales with every source's raw output.",
                        "default": 360
                    },
                    "cacheTtlSeconds": {
                        "title": "Cache time (seconds)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "How long to reuse results already fetched from a source instead of fetching again. Set 0 to always fetch fresh data.",
                        "default": 1800
                    },
                    "concurrency": {
                        "title": "Concurrency",
                        "minimum": 1,
                        "maximum": 12,
                        "type": "integer",
                        "description": "How many source boards to fetch at the same time.",
                        "default": 6
                    },
                    "runTimeoutSecs": {
                        "title": "Per-source timeout (seconds)",
                        "minimum": 30,
                        "type": "integer",
                        "description": "How long to wait for each source before giving up on it.",
                        "default": 120
                    },
                    "apifyToken": {
                        "title": "Apify API token",
                        "type": "string",
                        "description": "Leave empty — injected automatically when this Actor runs on the Apify platform. Only set this when running the code outside the platform, e.g. on your own machine."
                    },
                    "actorOwner": {
                        "title": "Actor owner",
                        "type": "string",
                        "description": "Which Apify account's child actors this bundle calls, e.g. 'nomad-agent'. Leave empty to use the published sources this bundle ships with — only set this if you run your own fork of the child actors under a different Apify account.",
                        "default": ""
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
