# American Jobs Scraper — 6 Sources in One (`nomad-agent/american-jobs-bundle`) Actor US job sources behind one endpoint: LinkedIn United States, AI Jobs, Built In, RemoteOK/Remotive/WeWorkRemotely/Himalayas, Hacker News Who Is Hiring and Y Combinator Work at a Startup. One merged, deduped dataset. - **URL**: https://apify.com/nomad-agent/american-jobs-bundle.md - **Developed by:** [Nomad.Dev](https://apify.com/nomad-agent) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 job results 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 ## American Jobs Scraper - 6 Sources in One One call for US-focused job data. This bundle fans out to 6 existing job-source Actors, merges their results, dedupes by URL, and returns one flat dataset of live American job postings. This is an unofficial scraper bundle. It is not affiliated with LinkedIn, AI Jobs, Built In, RemoteOK, Remotive, WeWorkRemotely, Himalayas, Hacker News, Y Combinator, or any listed employer. ### Sources included | Source key | Coverage | |---|---| | `linkedin` | LinkedIn jobs, default location: United States | | `ai_jobs_net` | AI, ML and data jobs with United States location | | `builtin` | US tech and startup jobs from Built In | | `remote_boards` | RemoteOK, Remotive, WeWorkRemotely and Himalayas | | `hackernews` | Hacker News Who Is Hiring | | `ycombinator_was` | Y Combinator Work at a Startup | Company ATS Actors like Greenhouse, Lever, Ashby and Workable are not included because they require buyer-supplied company lists. Wellfound is also excluded because the current source Actor is not public/priced, so external bundle users cannot reliably call it. ### How the bundle works This is a bundle Actor. For each selected source it calls the matching child Actor, maps every child record onto one shared schema, dedupes by URL, and pushes the merged output. Each source fails open independently: if one board errors or times out, the other sources still return. Use `sources` to run a cheaper subset, `keyword` to filter sources that support free-text search, and `location` to override the default `United States` text for LinkedIn and AI Jobs. ### Incremental mode Turn on `incrementalMode` for scheduled alerts. The bundle remembers listing URLs it has already delivered in a key-value store on your own Apify account. Later runs skip those already-seen postings and do not charge this bundle's per-result event for them. ### Input example ```json { "keyword": "software engineer", "location": "United States", "maxItemsPerSource": 10, "maxItems": 50 } ```` ### Output fields Each normal row uses the same flat bundle schema: ```json { "source": "linkedin", "id": "123456", "title": "Software Engineer", "company": "Example Inc.", "location": "United States", "url": "https://example.com/job/123456", "postedAt": "2026-07-07", "deadline": "", "snippet": "Short posting excerpt...", "salary": "" } ``` Fields a source does not provide are returned as empty strings rather than guessed. ### Python client ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("nomad-agent/american-jobs-bundle").call(run_input={ "keyword": "engineer", "maxItems": 50, }) items = client.dataset(run["defaultDatasetId"]).list_items().items print(len(items), items[:1]) ``` ### cURL ```bash curl -X POST \ "https://api.apify.com/v2/acts/nomad-agent~american-jobs-bundle/run-sync-get-dataset-items?token=" \ -H "Content-Type: application/json" \ -d '{"keyword":"engineer","maxItems":50}' ``` ### Cost note Children are pay-per-event Actors. A bundle run charges this bundle's start/result events on top of each enabled child Actor's own start/result events. Use `sources`, `maxItemsPerSource` and `maxItems` to control spend. # 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 and charges that child's own pay-per-event pricing on top of this bundle's fees, so fewer sources means lower cost. ## `keyword` (type: `string`): Optional free-text filter forwarded to children that support it. Built In ignores it and uses its default US tech categories. ## `location` (type: `string`): Location text forwarded to children that support location filtering, currently LinkedIn and AI Jobs. The default keeps those global sources US-focused. ## `incrementalMode` (type: `boolean`): Return only postings this bundle has not already delivered on a previous run. The bundle remembers every listing URL it returned in a private key-value store on your own Apify account. The first run returns everything; turn this on for scheduled daily or weekly alerts. ## `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 as well as by this bundle once it survives deduping. ## `maxItems` (type: `integer`): Hard cap on the merged, deduped output. Default (216) is sources x Max items per source. 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. Sources run in parallel, so this is a per-source ceiling, not a budget shared across them. ## `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. ## `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. ## Actor input object example ```json { "sources": [ "linkedin", "ai_jobs_net", "builtin", "remote_boards", "hackernews", "ycombinator_was" ], "location": "United States", "incrementalMode": false, "maxItemsPerSource": 36, "maxItems": 216, "cacheTtlSeconds": 1800, "concurrency": 6, "runTimeoutSecs": 300, "actorOwner": "" } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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/american-jobs-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 '' 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/american-jobs-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/american-jobs-bundle --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nomad-agent/american-jobs-bundle", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "American Jobs Scraper — 6 Sources in One", "description": "US job sources behind one endpoint: LinkedIn United States, AI Jobs, Built In, RemoteOK/Remotive/WeWorkRemotely/Himalayas, Hacker News Who Is Hiring and Y Combinator Work at a Startup. One merged, deduped dataset.", "version": "0.1", "x-build-id": "0nXkEvXcjLZPJPU6d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nomad-agent~american-jobs-bundle/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nomad-agent-american-jobs-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~american-jobs-bundle/runs": { "post": { "operationId": "runs-sync-nomad-agent-american-jobs-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~american-jobs-bundle/run-sync": { "post": { "operationId": "run-sync-nomad-agent-american-jobs-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 and charges that child's own pay-per-event pricing on top of this bundle's fees, so fewer sources means lower cost.", "items": { "type": "string", "enum": [ "linkedin", "ai_jobs_net", "builtin", "remote_boards", "hackernews", "ycombinator_was" ] }, "default": [ "linkedin", "ai_jobs_net", "builtin", "remote_boards", "hackernews", "ycombinator_was" ] }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional free-text filter forwarded to children that support it. Built In ignores it and uses its default US tech categories." }, "location": { "title": "US location", "type": "string", "description": "Location text forwarded to children that support location filtering, currently LinkedIn and AI Jobs. The default keeps those global sources US-focused.", "default": "United States" }, "incrementalMode": { "title": "Only new since last run", "type": "boolean", "description": "Return only postings this bundle has not already delivered on a previous run. The bundle remembers every listing URL it returned in a private key-value store on your own Apify account. The first run returns everything; turn this on for scheduled daily or weekly alerts.", "default": false }, "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 as well as by this bundle once it survives deduping.", "default": 36 }, "maxItems": { "title": "Max items (total)", "minimum": 0, "type": "integer", "description": "Hard cap on the merged, deduped output. Default (216) is sources x Max items per source. Set 0 to remove the cap; cost then scales with every source's raw output.", "default": 216 }, "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": 6, "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. Sources run in parallel, so this is a per-source ceiling, not a budget shared across them.", "default": 300 }, "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." }, "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.", "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 } } } } } } } } } } ```