# Talent.com Jobs Scraper (`crawlerbros/talent-com-jobs-scraper`) Actor

Scrape job listings from Talent.com - search by keyword and location, or fetch full job detail (salary, description, JobPosting metadata) by URL. No login, no API key, no paid proxy required.

- **URL**: https://apify.com/crawlerbros/talent-com-jobs-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Jobs, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Talent.com Jobs Scraper

Scrape job listings from [Talent.com](https://www.talent.com), one of the world's largest job search engines aggregating millions of listings across 78+ countries. Search by keyword and location, or fetch full job details (salary, description, posting date) for specific job URLs. No login, no API key, no paid proxy required.

### What this actor does

- **Two modes:** `search` (browse/filter job listings) and `byJobUrls` (fetch full detail for specific job URLs)
- **78 country sites:** search talent.com's dedicated site for any of its 78 countries (United States, United Kingdom, Canada, Germany, India, and 73 more) for genuinely local results, not just a US search under a foreign-sounding location name
- **Filters:** keyword, location, country, search radius, date posted, job type, remote-only, Quick Apply-only, sort order (relevance / most recent)
- **Rich detail records** (via `byJobUrls`): full description, salary range, employment type, posting/expiry dates
- **Empty fields are omitted**

### Output fields

- `recordType` — `"job"` (search result) or `"jobDetail"` (byJobUrls result)
- `jobId`, `jobUrl`
- `title`, `company`, `location`
- `salary` — as displayed on talent.com
- `employmentType` — e.g. Full-time, Part-time, Contract
- `postedAgo` — relative posting time (search mode)
- `datePosted`, `validThrough` — ISO dates (byJobUrls mode)
- `description`, `descriptionSnippet` (byJobUrls mode)
- `country` — the talent.com country site searched, if not the United States default
- `keyword`, `searchLocation`, `page` — echo of the search filters used

### Input options

| Field | Description |
|---|---|
| `mode` | `search` or `byJobUrls` |
| `keyword` | Job title or keyword (search mode) |
| `location` | City/state/region (search mode) |
| `country` | Which talent.com country site to search — United States (default), United Kingdom, Canada, Germany, India, and 73 more (search mode) |
| `radiusMiles` | Search radius in miles (5-100) |
| `sortBy` | `relevance` or `date` |
| `datePosted` | Only jobs posted in the last 1/3/7/14 days (search mode) |
| `jobType` | Full-time / Part-time / Permanent / Temporary / Internship (search mode) |
| `remoteOnly` | Only remote/work-from-home jobs (search mode) |
| `quickApplyOnly` | Only jobs supporting talent.com's one-click Quick Apply (search mode) |
| `jobUrls` | List of talent.com job URLs (byJobUrls mode) |
| `maxItems` | Max records to return |
| `maxPages` | Max search-result pages to crawl (search mode) |
| `proxyConfiguration` | Optional Apify proxy (free AUTO datacenter group used only if needed) |

### Example: search jobs

```json
{
  "mode": "search",
  "keyword": "software engineer",
  "location": "New York, NY",
  "radiusMiles": 25,
  "sortBy": "relevance",
  "maxItems": 50,
  "maxPages": 5
}
```

### Example: search jobs outside the US

```json
{
  "mode": "search",
  "keyword": "nurse",
  "location": "London",
  "country": "uk",
  "maxItems": 50,
  "maxPages": 5
}
```

### Example: fetch job details

```json
{
  "mode": "byJobUrls",
  "jobUrls": ["https://www.talent.com/view?id=630921865107343938"]
}
```

### Use cases

- **Job boards & aggregators** — pull fresh listings into your own site or newsletter
- **Recruiting & sourcing** — monitor new postings for target companies or roles
- **Labor market research** — track hiring volume, salary ranges, and job types by location or country
- **Sales/lead generation** — find companies actively hiring to target for B2B outreach
- **Career sites** — build location- or keyword-specific job feeds for niche audiences
- **Competitive intelligence** — see which roles competitors are hiring for and where

### FAQ

**Do I need a Talent.com account or API key?** No — this actor scrapes public search results and job pages.

**Why are some fields missing from a record?** Talent.com doesn't display every field (e.g. salary) for every job. Only fields with real data are included — never `null` or placeholder values.

**Does this work outside the US?** Yes — set `country` to the country you want (e.g. United Kingdom, Canada, Germany, India — 78 countries are supported) and pass the city/region in `location`. The `country` field matters: talent.com runs a separate site per country, so leaving `country` at its United States default and just typing a foreign city into `location` (e.g. "London") will silently match a same-named US town ("London, OH") instead of the country you meant. For ambiguous city names that also exist as small towns elsewhere (e.g. "Montreal" is also a town in Wisconsin), include the state/province for extra accuracy — e.g. "Montreal, QC".

**Are `salary`, `employmentType`, and `postedAgo` available on every country site?** `title`, `company`, `location`, and `jobUrl` are reliable on every country site. `salary`, `employmentType`, and `postedAgo` are parsed from English-language badge text, so they populate reliably on English-speaking country sites (United States, United Kingdom, Canada, Australia, Ireland, India, etc.) and are omitted (never guessed or mistranslated) on sites in other languages.

**Why did I get fewer than `maxItems` results?** Talent.com's own search results pages are capped — most keyword/location combinations expose roughly 5-10 pages (~70-150 unique jobs) before pagination ends, even for broad queries. Set `maxItems`/`maxPages` as high as you like; the actor returns everything talent.com actually exposes and stops cleanly once it does.

# Actor input Schema

## `mode` (type: `string`):

search: browse/filter job listings by keyword and location. byJobUrls: fetch full job detail (description, salary, JobPosting metadata) for specific talent.com job URLs.

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

Job title or keyword to search for (mode=search). Example: "software engineer", "nurse", "warehouse".

## `location` (type: `string`):

City, state, or region to search in (mode=search). Example: "New York, NY", "London", "Toronto". Leave empty to search all locations.

## `country` (type: `string`):

Which talent.com country site to search (mode=search). Talent.com runs a separate site per country with genuinely local results — e.g. "London" only returns UK jobs if Country is set to United Kingdom; left at United States, "London" instead matches the US town of that name.

## `radiusMiles` (type: `integer`):

Distance from the location to include in results, in miles (mode=search). Common values: 5, 10, 25, 50, 100.

## `sortBy` (type: `string`):

Result ordering (mode=search).

## `datePosted` (type: `string`):

Only return jobs posted within this many days (mode=search). Leave empty for any time.

## `jobType` (type: `string`):

Only return jobs of this employment type (mode=search). Leave empty for all types.

## `remoteOnly` (type: `boolean`):

Only return remote/work-from-home jobs (mode=search).

## `quickApplyOnly` (type: `boolean`):

Only return jobs that support talent.com's one-click Quick Apply (mode=search).

## `jobUrls` (type: `array`):

Full talent.com job URLs to fetch details for (mode=byJobUrls). Example: https://www.talent.com/view?id=123456789012345678

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

Maximum number of job records to return.

## `maxPages` (type: `integer`):

Maximum number of search-result pages to crawl (mode=search). Each page holds ~20 jobs.

## `proxyConfiguration` (type: `object`):

Optional. Only used automatically if talent.com starts blocking requests; the free AUTO datacenter group is used.

## Actor input object example

```json
{
  "mode": "search",
  "keyword": "software engineer",
  "location": "New York, NY",
  "country": "www",
  "radiusMiles": 25,
  "sortBy": "relevance",
  "remoteOnly": false,
  "quickApplyOnly": false,
  "jobUrls": [
    "https://www.talent.com/view?id=630921865107343938"
  ],
  "maxItems": 50,
  "maxPages": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `jobs` (type: `string`):

Dataset containing all scraped job records.

# 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 = {
    "mode": "search",
    "keyword": "software engineer",
    "location": "New York, NY",
    "country": "www",
    "radiusMiles": 25,
    "sortBy": "relevance",
    "jobUrls": [
        "https://www.talent.com/view?id=630921865107343938"
    ],
    "maxItems": 50,
    "maxPages": 5,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/talent-com-jobs-scraper").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 = {
    "mode": "search",
    "keyword": "software engineer",
    "location": "New York, NY",
    "country": "www",
    "radiusMiles": 25,
    "sortBy": "relevance",
    "jobUrls": ["https://www.talent.com/view?id=630921865107343938"],
    "maxItems": 50,
    "maxPages": 5,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/talent-com-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "keyword": "software engineer",
  "location": "New York, NY",
  "country": "www",
  "radiusMiles": 25,
  "sortBy": "relevance",
  "jobUrls": [
    "https://www.talent.com/view?id=630921865107343938"
  ],
  "maxItems": 50,
  "maxPages": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call crawlerbros/talent-com-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawlerbros/talent-com-jobs-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/QZl5xVFXtK0zIr7hb/builds/FHHLAIbkw95U2M7ig/openapi.json