# Jobs Intelligence Bundle (`runtime/jobs-intelligence-bundle`) Actor Track hiring signals and company hiring intent from job boards, career pages, and web discovery, then save scored AI-ready jobs intelligence records. - **URL**: https://apify.com/runtime/jobs-intelligence-bundle.md - **Developed by:** [scraping automation](https://apify.com/runtime) (community) - **Categories:** Lead generation, Business, AI - **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 ## Jobs Intelligence Bundle Track hiring intent from job boards, career pages, and search results, then save scored opportunity records. ### Who this is for - Sales teams - Recruiting intelligence teams - Market researchers ### What it helps you do - Detect companies hiring for specific roles - Find job URLs and source evidence - Score hiring intent and lead fit ### Inputs you can use - Role, keyword, company, or city - Job board and search settings - Maximum jobs ### Data you get - company - job title - location - job URL - source - signal score - evidence ### How to get better results - Start with a narrow, specific query or a small list of source URLs. - Use realistic limits for the first run, then increase the volume once the output looks right. - Keep source URLs, dates, and location context when you need repeatable market monitoring. - Review a few sample records before connecting the dataset to a larger workflow. ### Notes - Results depend on what the public source exposes at run time. - Some pages may hide, delay, rename, or remove fields, so individual records can have partial data. - Use the built-in output table to inspect results before exporting to spreadsheets, dashboards, or automation tools. ### Support If a run returns unexpected data, open an issue from the Actor page with the input used, the run ID, and the result you expected. # Actor input Schema ## `workflow` (type: `string`): Business workflow label stored on each output item. ## `keyword` (type: `string`): Single role or keyword. Used when Keywords is empty. ## `keywords` (type: `array`): Batch roles or keywords, one per line. When non-empty, this overrides Keyword. ## `company` (type: `string`): Optional single target company. Used when Companies is empty. ## `companies` (type: `array`): Target companies, one per line. ## `location` (type: `string`): Single target location. Used when Locations is empty. ## `locations` (type: `array`): Target locations, one per line. ## `country` (type: `string`): Country context stored on normalized records. ## `targetProviders` (type: `array`): Provider domains to include in generated search queries. ## `includeManualJobs` (type: `boolean`): Normalize jobs provided in Manual jobs. ## `manualJobs` (type: `array`): Optional jobs or hiring pages from providers to normalize into the bundle dataset. ## `includeWebDiscovery` (type: `boolean`): Collect supporting hiring and job signals using direct web search. ## `searchQueries` (type: `array`): Optional custom search queries, one per line. If empty, the Actor generates provider-aware job queries. ## `searchProviders` (type: `array`): Search providers to use. Brave requires BRAVE_SEARCH_API_KEY or braveApiKey. ## `braveApiKey` (type: `string`): Optional Brave Search API key. Prefer using the BRAVE_SEARCH_API_KEY environment variable. ## `maxResults` (type: `integer`): Maximum normalized records saved by the bundle. ## `maxWebQueries` (type: `integer`): Maximum generated/custom web queries to execute. ## `maxWebResults` (type: `integer`): Maximum web-discovery results to normalize. ## `mockMode` (type: `boolean`): Generate sample jobs intelligence records without network access. ## `failOnNoResults` (type: `boolean`): Fail the run if no normalized records are produced. ## `requestTimeoutSecs` (type: `integer`): Timeout for web search requests. ## `useApifyProxy` (type: `boolean`): Enable Apify Proxy for direct web discovery. ## `proxyConfiguration` (type: `object`): Advanced Apify Proxy or custom proxy settings. ## Actor input object example ```json { "workflow": "company-hiring-radar", "keyword": "data analyst", "keywords": [], "company": "", "companies": [], "location": "Paris", "locations": [], "country": "France", "targetProviders": [ "welcometothejungle", "hellowork", "jobteaser" ], "includeManualJobs": true, "manualJobs": [], "includeWebDiscovery": true, "searchQueries": [], "searchProviders": [ "duckduckgo" ], "maxResults": 25, "maxWebQueries": 6, "maxWebResults": 20, "mockMode": false, "failOnNoResults": true, "requestTimeoutSecs": 20, "useApifyProxy": false, "proxyConfiguration": {} } ```` # Actor output Schema ## `source` (type: `string`): Source module ## `provider` (type: `string`): Job board, careers site, or discovery provider ## `workflow` (type: `string`): Workflow that produced the record ## `title` (type: `string`): Job title or hiring signal title ## `company` (type: `string`): Hiring company ## `location` (type: `string`): Job location ## `country` (type: `string`): Job country ## `contractType` (type: `string`): Contract or employment type ## `salary` (type: `string`): Salary text when available ## `postedAt` (type: `string`): Posted date when available ## `applyUrl` (type: `string`): Job or hiring-page URL ## `url` (type: `string`): Primary URL ## `description` (type: `string`): Job description or search snippet ## `hiringSignal` (type: `string`): open\_role, hiring\_page, or market\_signal ## `remote` (type: `string`): Remote-work flag when available ## `seniority` (type: `string`): Seniority when available ## `department` (type: `string`): Department or function when available ## `confidence` (type: `string`): 0-100 extraction confidence ## `reviewStatus` (type: `string`): accepted or needs\_review ## `sourceUrl` (type: `string`): Source or listing URL ## `sourceQuery` (type: `string`): Search query that produced the record ## `sourcePosition` (type: `string`): Position in the source listing ## `sourceData` (type: `string`): Source-specific fields preserved after normalization ## `scrapedAt` (type: `string`): ISO timestamp when the record was created # 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 = { "keyword": "data analyst" }; // Run the Actor and wait for it to finish const run = await client.actor("runtime/jobs-intelligence-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 = { "keyword": "data analyst" } # Run the Actor and wait for it to finish run = client.actor("runtime/jobs-intelligence-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 '{ "keyword": "data analyst" }' | apify call runtime/jobs-intelligence-bundle --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=runtime/jobs-intelligence-bundle", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jobs Intelligence Bundle", "description": "Track hiring signals and company hiring intent from job boards, career pages, and web discovery, then save scored AI-ready jobs intelligence records.", "version": "0.1", "x-build-id": "HFc4RJsSHrAI1j85p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/runtime~jobs-intelligence-bundle/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-runtime-jobs-intelligence-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/runtime~jobs-intelligence-bundle/runs": { "post": { "operationId": "runs-sync-runtime-jobs-intelligence-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/runtime~jobs-intelligence-bundle/run-sync": { "post": { "operationId": "run-sync-runtime-jobs-intelligence-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": { "workflow": { "title": "Workflow", "enum": [ "company-hiring-radar", "french-job-market-watch", "custom" ], "type": "string", "description": "Business workflow label stored on each output item.", "default": "company-hiring-radar" }, "keyword": { "title": "Keyword", "type": "string", "description": "Single role or keyword. Used when Keywords is empty.", "default": "data analyst" }, "keywords": { "title": "Keywords", "type": "array", "description": "Batch roles or keywords, one per line. When non-empty, this overrides Keyword.", "items": { "type": "string" }, "default": [] }, "company": { "title": "Company", "type": "string", "description": "Optional single target company. Used when Companies is empty.", "default": "" }, "companies": { "title": "Companies", "type": "array", "description": "Target companies, one per line.", "items": { "type": "string" }, "default": [] }, "location": { "title": "Location", "type": "string", "description": "Single target location. Used when Locations is empty.", "default": "Paris" }, "locations": { "title": "Locations", "type": "array", "description": "Target locations, one per line.", "items": { "type": "string" }, "default": [] }, "country": { "title": "Country", "type": "string", "description": "Country context stored on normalized records.", "default": "France" }, "targetProviders": { "title": "Target providers", "type": "array", "description": "Provider domains to include in generated search queries.", "items": { "type": "string", "enum": [ "welcometothejungle", "hellowork", "jobteaser", "indeed", "cadremploi", "upwork" ], "enumTitles": [ "Welcome to the Jungle", "Hellowork", "JobTeaser", "Indeed", "Cadremploi", "Upwork" ] }, "default": [ "welcometothejungle", "hellowork", "jobteaser" ] }, "includeManualJobs": { "title": "Include manual jobs", "type": "boolean", "description": "Normalize jobs provided in Manual jobs.", "default": true }, "manualJobs": { "title": "Manual jobs", "type": "array", "description": "Optional jobs or hiring pages from providers to normalize into the bundle dataset.", "items": { "type": "object", "properties": { "provider": { "title": "Provider", "description": "Source provider, such as welcometothejungle, hellowork, jobteaser, or company-careers.", "type": "string" }, "title": { "title": "Title", "description": "Job title or hiring-page title.", "type": "string" }, "company": { "title": "Company", "description": "Company hiring for the role.", "type": "string" }, "location": { "title": "Location", "description": "Job location.", "type": "string" }, "country": { "title": "Country", "description": "Job country.", "type": "string" }, "applyUrl": { "title": "Apply URL", "description": "Job or hiring-page URL.", "type": "string" }, "description": { "title": "Description", "description": "Job or hiring-page description.", "type": "string" } } }, "default": [] }, "includeWebDiscovery": { "title": "Collect web signals", "type": "boolean", "description": "Collect supporting hiring and job signals using direct web search.", "default": true }, "searchQueries": { "title": "Custom search queries", "type": "array", "description": "Optional custom search queries, one per line. If empty, the Actor generates provider-aware job queries.", "items": { "type": "string" }, "default": [] }, "searchProviders": { "title": "Search providers", "type": "array", "description": "Search providers to use. Brave requires BRAVE_SEARCH_API_KEY or braveApiKey.", "items": { "type": "string", "enum": [ "duckduckgo", "brave" ], "enumTitles": [ "DuckDuckGo", "Brave Search API" ] }, "default": [ "duckduckgo" ] }, "braveApiKey": { "title": "Brave API key", "type": "string", "description": "Optional Brave Search API key. Prefer using the BRAVE_SEARCH_API_KEY environment variable." }, "maxResults": { "title": "Max output records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum normalized records saved by the bundle.", "default": 25 }, "maxWebQueries": { "title": "Max web queries", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum generated/custom web queries to execute.", "default": 6 }, "maxWebResults": { "title": "Max web results", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum web-discovery results to normalize.", "default": 20 }, "mockMode": { "title": "Mock mode", "type": "boolean", "description": "Generate sample jobs intelligence records without network access.", "default": false }, "failOnNoResults": { "title": "Fail on no results", "type": "boolean", "description": "Fail the run if no normalized records are produced.", "default": true }, "requestTimeoutSecs": { "title": "Request timeout seconds", "minimum": 5, "maximum": 120, "type": "integer", "description": "Timeout for web search requests.", "default": 20 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Enable Apify Proxy for direct web discovery.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Advanced Apify Proxy or custom proxy settings.", "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 } } } } } } } } } } ```