# Jobs Data API - ATS Job Listings by Company and Country (`nabeelbaghoor/jobdata-api`) Actor Search the jobdata API and export structured job listings sourced from company applicant tracking systems - title, company, location, country, remote flag, employment type, salary and apply link. Filter by country, region, city, company and remote. Pay per result. Bring your own API key. - **URL**: https://apify.com/nabeelbaghoor/jobdata-api.md - **Developed by:** [Nabeel Hassan](https://apify.com/nabeelbaghoor) (community) - **Categories:** Jobs, Developer tools, Lead generation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $10.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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Data API - ATS job listings by company and country **Jobs Data API** turns the jobdata API into a clean, structured dataset. Filter by country, company, city and remote, and get back job listings sourced directly from company applicant tracking systems - title, company, location, country, remote flag, employment type, salary and a direct apply link - ready to export as JSON, CSV or Excel. Bring your own jobdata API key and pay only for the results you keep. ### Why use this actor? - **ATS-sourced listings** - jobs pulled from company applicant tracking systems and career pages, with clean company attribution. - **Structured output** - title, company (with website and LinkedIn), location, city, region, country, remote flag, employment type, experience level, salary range and apply link, parsed into flat columns. - **Precise filters** - job title, company, country code, region, city, remote-only and maximum age in days. - **Pay per result** - you are charged only for the jobs actually returned. - **No proxies, no blocks** - data comes through a stable API, so runs are fast and reliable. ### Use cases - **Recruiting and sourcing** - see which companies are hiring for which roles, by country and city. - **Company and hiring signals** - a company that is hiring is a company that is growing and buying. - **Market and salary research** - track demand and pay by role, country and industry. - **Lead generation** - build lists of hiring companies with website and LinkedIn attribution. - **Job alert automations** - schedule daily runs and push new matches to Slack, email or your ATS. ### Input Configure everything from the visual editor - every filter is a proper field, no code needed. Example JSON input: ```json { "title": "software engineer", "country": "US", "remote": true, "maxAge": 30, "maxResults": 100, "apiKey": "YOUR_API_KEY" } ```` ### Output One clean JSON object per job: ```json { "job_title": "Senior Software Engineer", "company_name": "Acme Corp", "company_website": "https://acme.com", "company_linkedin": "https://www.linkedin.com/company/acme", "location": "San Francisco, CA", "city": "San Francisco", "region": "California", "country": "United States", "has_remote": true, "employment_type": "Full-time", "salary": "150000 - 210000 USD", "published": "2026-07-22T00:00:00Z", "apply_link": "https://acme.com/careers/senior-software-engineer", "job_id": 12345678 } ``` ### Do I need an API key? Yes. This actor calls the jobdata API on your behalf, which requires your own API key. Create a key at jobdataapi.com, paste it into the **API key** field, and run. Your key is stored securely and never logged. ### Pay per result You pay only for the job listings the actor actually returns - no subscriptions, no minimums. Set **Maximum results** to cap each run's spend exactly. ### FAQ #### What is the Jobs Data API? The Jobs Data API (jobdata API) returns job listings collected from company applicant tracking systems and career pages as structured data - title, company, location, country, remote flag, employment type, salary and apply link. It lets you pull hiring data programmatically instead of scraping individual career sites. #### Where does the data come from? From the jobdata API, which aggregates postings from company ATS platforms and career pages, normalized into a single schema with consistent company, location and salary fields. #### What filters can I use? Job title, company, country code, region, city, remote-only, and a maximum age in days. Some advanced filters (full-text search, expired jobs, company profiles) require higher jobdata API plans; this actor uses the filters available on standard plans. #### How many results can I get per run? As many as your search matches, collected in pages. Use **Maximum results** to set an exact cap. For very large pulls, split the search by country or company. #### How much does it cost? Pricing is pay-per-result: a small fixed amount for every job returned, plus standard Apify platform usage, plus your own jobdata API usage (billed by jobdata against your key). A run that returns nothing costs almost nothing. #### Is salary always included? No. Salary is only present when the source listing provides it, so the salary fields can be empty for some jobs. All available fields are passed through as-is. #### Can I run this on a schedule? Yes. Use Apify Schedules to run it hourly or daily and connect the dataset to Zapier, Make, n8n, webhooks or the API to pipe new jobs anywhere. #### Is this legal? The actor returns publicly available job listings through the jobdata API using your own licensed API key. No login-walled or personal data is collected. ### Keyword map jobs data api, jobdata api, ats jobs api, ats job data, job listings api, hiring data api, company jobs api, job postings api, remote jobs api, recruiting data api, job market data api, career data api. ### Support and feedback Found an issue or missing a filter? Open an issue in the **Issues** tab - it is monitored daily. # Actor input Schema ## `title` (type: `string`): Filter by words in the job title, e.g. `engineer`, `product manager`, `nurse`. Leave empty to include all titles. ## `company` (type: `string`): Filter to a single company by name, e.g. `Stripe`. Leave empty to include all companies. ## `country` (type: `string`): Two-letter ISO country code to filter by, e.g. `US`, `GB`, `DE`, `IN`. Leave empty to include all countries. ## `region` (type: `string`): Region or state name to filter by, e.g. `California`, `Bavaria`. Leave empty to include all. ## `city` (type: `string`): City name to filter by, e.g. `Berlin`, `San Francisco`. Leave empty to include all cities. ## `remote` (type: `boolean`): Return only jobs flagged as remote. ## `maxAge` (type: `integer`): Only return jobs published within this many days. Defaults to 90 on the lite plan. ## `maxResults` (type: `integer`): Stop after this many jobs. Results are collected in pages. You are charged per result returned. ## `pageSize` (type: `integer`): How many jobs to request per page (advanced). Leave at the default unless tuning throughput. ## `apiKey` (type: `string`): Your own jobdata API key. Required - the actor calls the jobs API on your behalf using this key. Get one at jobdataapi.com. Stored securely and never logged. ## Actor input object example ```json { "title": "software engineer", "remote": false, "maxAge": 30, "maxResults": 100, "pageSize": 50 } ``` # 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 = { "title": "software engineer", "maxAge": 30, "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("nabeelbaghoor/jobdata-api").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 = { "title": "software engineer", "maxAge": 30, "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("nabeelbaghoor/jobdata-api").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 '{ "title": "software engineer", "maxAge": 30, "maxResults": 100 }' | apify call nabeelbaghoor/jobdata-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nabeelbaghoor/jobdata-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jobs Data API - ATS Job Listings by Company and Country", "description": "Search the jobdata API and export structured job listings sourced from company applicant tracking systems - title, company, location, country, remote flag, employment type, salary and apply link. Filter by country, region, city, company and remote. Pay per result. Bring your own API key.", "version": "0.1", "x-build-id": "AohWxemQrf5ihCMhg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~jobdata-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-jobdata-api", "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/nabeelbaghoor~jobdata-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-jobdata-api", "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/nabeelbaghoor~jobdata-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-jobdata-api", "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": { "title": { "title": "Job title contains", "type": "string", "description": "Filter by words in the job title, e.g. `engineer`, `product manager`, `nurse`. Leave empty to include all titles." }, "company": { "title": "Company", "type": "string", "description": "Filter to a single company by name, e.g. `Stripe`. Leave empty to include all companies." }, "country": { "title": "Country code", "type": "string", "description": "Two-letter ISO country code to filter by, e.g. `US`, `GB`, `DE`, `IN`. Leave empty to include all countries." }, "region": { "title": "Region / state", "type": "string", "description": "Region or state name to filter by, e.g. `California`, `Bavaria`. Leave empty to include all." }, "city": { "title": "City", "type": "string", "description": "City name to filter by, e.g. `Berlin`, `San Francisco`. Leave empty to include all cities." }, "remote": { "title": "Remote only", "type": "boolean", "description": "Return only jobs flagged as remote.", "default": false }, "maxAge": { "title": "Maximum age (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only return jobs published within this many days. Defaults to 90 on the lite plan." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many jobs. Results are collected in pages. You are charged per result returned." }, "pageSize": { "title": "Results per page", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many jobs to request per page (advanced). Leave at the default unless tuning throughput.", "default": 50 }, "apiKey": { "title": "API key", "type": "string", "description": "Your own jobdata API key. Required - the actor calls the jobs API on your behalf using this key. Get one at jobdataapi.com. Stored securely and never logged." } } }, "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 } } } } } } } } } } ```