# Careerjet Job Search API - Jobs in 70 Markets (`nabeelbaghoor/careerjet-job-search-api`) Actor Search the Careerjet job engine across 70 country and language markets and export structured listings - title, company, location, salary and apply link - filtered by keyword, location, contract type and period. Pay per result. Bring your own affiliate ID. - **URL**: https://apify.com/nabeelbaghoor/careerjet-job-search-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 $8.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 ## Careerjet Job Search API - jobs across 70 markets **Careerjet Job Search API** turns the Careerjet job engine into a clean, structured dataset. Search any of 70 country and language markets by keyword and location, and export every matching listing - job title, company, location, salary and a direct apply link - as JSON, CSV or Excel. Bring your own Careerjet affiliate ID (free to register) and pay only for the results you keep. ### Why use this actor? - **70 markets worldwide** - a dedicated index per country and language, from the United States and United Kingdom to Germany, France, Spain, Japan, Brazil and more. - **Rich structured output** - title, company, location, salary, posting date, source site and apply link, parsed into flat columns. - **Precise filters** - keywords, location, contract type (permanent, contract, temporary, training, voluntary) and period (full-time, part-time), with sort by relevance, date or salary. - **Smart location handling** - if a location is ambiguous, the actor surfaces Careerjet's suggested alternatives so you can requery cleanly. - **Pay per result** - you are charged only for the jobs actually returned, up to 1,000 per run. - **No proxies, no blocks** - data comes through a stable API, so runs are fast and reliable. ### Use cases - **Job boards and aggregators** - stock your board with fresh listings across countries and languages. - **Recruiting and sourcing** - track who is hiring for which roles and where. - **Labor market research** - analyze hiring demand by role, city, country or language market. - **Lead generation** - hiring companies are spending companies; time outreach on hiring signals. - **Job alerts** - 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 { "locale": "en_GB", "keywords": "python developer", "location": "London", "contractPeriod": "f", "sort": "date", "maxResults": 100, "affiliateId": "YOUR_AFFILIATE_ID" } ```` ### Output One clean JSON object per job: ```json { "title": "Senior Python Developer", "company": "Acme Ltd", "locations": "London", "salary": "60,000 - 80,000 per year", "date": "Fri, 18 Jul 2026 09:12:00 GMT", "site": "example-jobs.com", "url": "https://www.careerjet.co.uk/jobview/...", "description": "We are hiring a Senior Python Developer..." } ``` ### Do I need an API key? Yes - a Careerjet **affiliate ID**. This actor calls the Careerjet API on your behalf, which requires your own affiliate (partner) ID. Register for free at careerjet.com/partners, paste your ID into the input, and run. The Careerjet API also requires an end-user IP, User-Agent and referrer on every request; the actor supplies sensible values automatically, so you normally only need the affiliate ID. Your credentials are 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 Careerjet Job Search API? Careerjet is a job search engine that aggregates listings from thousands of job boards, recruitment agencies and company career sites across 70 country and language markets. Its public search API returns those listings as structured data - title, company, location, salary and apply link - so you can build job boards, run market research or feed hiring data into your own tools without scraping. #### Which markets are supported? 70 locale markets in the form language\_COUNTRY, covering English (UK, US, Canada, Australia, India, Singapore and more), German, French, Spanish, Italian, Dutch, Portuguese, Polish, Russian, Turkish, Japanese, Korean, Chinese, Vietnamese and others. Each market is a separate index selected with the **Country / language market** field. #### What filters can I use? Keywords (matched against title, content and company), location, contract type (permanent, contract, temporary, training, voluntary), contract period (full-time, part-time), and sort order (relevance, date or salary). #### How does location matching work? Enter a city, region or postcode. If Careerjet finds the location ambiguous, the actor does not guess - it logs the list of suggested alternatives so you can re-run with an exact match. #### How many results can I get per run? Up to 1,000 jobs per run, paged automatically (up to 100 per request). For larger pulls, split by market, keyword or location, or run on a schedule and collect new listings each day sorted by date. #### How much does it cost? Pricing is pay-per-result: a small fixed amount per job returned, plus standard Apify platform usage. Your Careerjet affiliate account itself is free. A run that returns nothing costs almost nothing. #### 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 from the Careerjet search API, retrieved through a licensed affiliate account. No login-walled or personal data is collected. ### Keyword map careerjet api, careerjet job search api, job search api, jobs api, international jobs api, job listings api, uk jobs api, us jobs api, job market data, recruitment data api, job postings api, worldwide jobs 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 ## `locale` (type: `string`): The Careerjet index to search, as a language\_COUNTRY locale code. Each market is a separate index. ## `keywords` (type: `string`): Search terms matched against job title, content and company, e.g. `python developer`. Leave empty to return all jobs in the market. ## `location` (type: `string`): City, region or postcode within the selected market, e.g. `London`, `Manchester`. Leave empty for the whole country. If the location is ambiguous, the actor logs the suggested alternatives. ## `contractType` (type: `string`): Filter by type of contract. ## `contractPeriod` (type: `string`): Filter by full-time or part-time. ## `sort` (type: `string`): Order of results. ## `pageSize` (type: `integer`): How many jobs to request per API call (1-100). The actor pages automatically up to Maximum results. ## `maxResults` (type: `integer`): Stop after this many jobs (1-1,000). You are charged per result returned. ## `affiliateId` (type: `string`): Your Careerjet affiliate (partner) ID. Required. Register free at careerjet.com/partners. Stored securely and never logged. ## `userIp` (type: `string`): The Careerjet API requires an end-user IP. Leave empty and the actor auto-detects its own public IP. Override only if you need to attribute results to a specific visitor. ## `userAgent` (type: `string`): The Careerjet API requires an end-user User-Agent. Leave empty to use a sensible browser default. ## `referrerUrl` (type: `string`): The URL of the page displaying results, sent as the referer. Leave empty to use a default. ## Actor input object example ```json { "locale": "en_GB", "contractType": "", "contractPeriod": "", "sort": "relevance", "pageSize": 50, "maxResults": 100 } ``` # 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 = { "keywords": "", "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("nabeelbaghoor/careerjet-job-search-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 = { "keywords": "", "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("nabeelbaghoor/careerjet-job-search-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 '{ "keywords": "", "maxResults": 100 }' | apify call nabeelbaghoor/careerjet-job-search-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nabeelbaghoor/careerjet-job-search-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Careerjet Job Search API - Jobs in 70 Markets", "description": "Search the Careerjet job engine across 70 country and language markets and export structured listings - title, company, location, salary and apply link - filtered by keyword, location, contract type and period. Pay per result. Bring your own affiliate ID.", "version": "0.1", "x-build-id": "z79AWYHpzgbBi6q56" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~careerjet-job-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-careerjet-job-search-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~careerjet-job-search-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-careerjet-job-search-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~careerjet-job-search-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-careerjet-job-search-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": { "locale": { "title": "Country / language market", "enum": [ "en_GB", "en_US", "en_CA", "en_AU", "en_IE", "en_NZ", "en_ZA", "en_IN", "en_SG", "en_HK", "en_MY", "en_PH", "en_PK", "en_BD", "en_AE", "en_SA", "en_QA", "en_KW", "en_OM", "en_CN", "en_TW", "en_VN", "de_DE", "de_AT", "de_CH", "fr_FR", "fr_BE", "fr_CH", "fr_CA", "fr_LU", "fr_MA", "es_ES", "es_MX", "es_AR", "es_CL", "es_CO", "es_PE", "es_VE", "es_EC", "es_BO", "es_CR", "es_DO", "es_GT", "es_PA", "es_PR", "es_PY", "es_UY", "it_IT", "nl_NL", "nl_BE", "pt_PT", "pt_BR", "pl_PL", "ru_RU", "ru_UA", "uk_UA", "cs_CZ", "sk_SK", "hu_HU", "tr_TR", "da_DK", "sv_SE", "no_NO", "fi_FI", "ja_JP", "ko_KR", "zh_CN", "vi_VN" ], "type": "string", "description": "The Careerjet index to search, as a language_COUNTRY locale code. Each market is a separate index.", "default": "en_GB" }, "keywords": { "title": "Keywords", "type": "string", "description": "Search terms matched against job title, content and company, e.g. `python developer`. Leave empty to return all jobs in the market." }, "location": { "title": "Location", "type": "string", "description": "City, region or postcode within the selected market, e.g. `London`, `Manchester`. Leave empty for the whole country. If the location is ambiguous, the actor logs the suggested alternatives." }, "contractType": { "title": "Contract type", "enum": [ "", "p", "c", "t", "i", "v" ], "type": "string", "description": "Filter by type of contract.", "default": "" }, "contractPeriod": { "title": "Contract period", "enum": [ "", "f", "p" ], "type": "string", "description": "Filter by full-time or part-time.", "default": "" }, "sort": { "title": "Sort by", "enum": [ "relevance", "date", "salary" ], "type": "string", "description": "Order of results.", "default": "relevance" }, "pageSize": { "title": "Results per page", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many jobs to request per API call (1-100). The actor pages automatically up to Maximum results.", "default": 50 }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many jobs (1-1,000). You are charged per result returned." }, "affiliateId": { "title": "Affiliate ID", "type": "string", "description": "Your Careerjet affiliate (partner) ID. Required. Register free at careerjet.com/partners. Stored securely and never logged." }, "userIp": { "title": "End-user IP (optional)", "type": "string", "description": "The Careerjet API requires an end-user IP. Leave empty and the actor auto-detects its own public IP. Override only if you need to attribute results to a specific visitor." }, "userAgent": { "title": "End-user User-Agent (optional)", "type": "string", "description": "The Careerjet API requires an end-user User-Agent. Leave empty to use a sensible browser default." }, "referrerUrl": { "title": "Referrer URL (optional)", "type": "string", "description": "The URL of the page displaying results, sent as the referer. Leave empty to use a 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 } } } } } } } } } } ```