# Talroo Job Search API - Jobs Across the Talroo Network (`nabeelbaghoor/talroo-job-search-api`) Actor

Search the Talroo job network and export structured job listings - title, company, location, salary, benefits and apply link - filtered by keyword, location, radius, work type and benefits. Pay per result. Bring your own publisher credentials.

- **URL**: https://apify.com/nabeelbaghoor/talroo-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/actors/running/actors-in-store.md#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

## Talroo Job Search API - jobs across the Talroo network

**Talroo Job Search API** turns the Talroo job network into a clean, structured dataset. Search millions of active listings by keyword and location, and export every matching job - title, company, location, salary, benefits and a direct apply link - as JSON, CSV or Excel.

Bring your own Talroo Publisher credentials and pay only for the results you keep.

### Why use this actor?

- **Millions of live jobs** - the Talroo network aggregates listings from employers, job boards and career sites across the United States.
- **Rich structured output** - title, company, location, salary, posting date, benefits, work type and apply link, parsed into flat columns.
- **Precise filters** - keywords, location, search radius, commute time, salary range, benefits and work type (full-time, part-time, internship, work from home, gig, entry level, no experience).
- **Full descriptions** - pull the complete job description for every listing, not just a snippet.
- **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, high-volume listings.
- **Recruiting and sourcing** - track who is hiring for which roles and where.
- **Labor market research** - analyze hiring demand by role, city, salary band or work type.
- **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
{
  "keywords": "registered nurse",
  "location": "Austin, TX",
  "radiusKm": 40,
  "salaryMin": 60000,
  "workTypes": ["fulltime", "healthcare"],
  "benefits": ["healthcare", "retirement"],
  "fullDescription": true,
  "maxResults": 100,
  "publisherId": "YOUR_PUBLISHER_ID",
  "apiKey": "YOUR_PUBLISHER_PASSWORD"
}
```

### Output

One clean JSON object per job:

```json
{
  "title": "Registered Nurse (RN)",
  "company": "Example Health System",
  "location": "Austin, TX",
  "salary": "70,000 - 95,000 per year",
  "date": "2026-07-18",
  "url": "https://www.jobs2careers.com/click.php?...",
  "description": "We are hiring a Registered Nurse to join our team...",
  "id": "1234567890",
  "ad_type": "cpc",
  "coordinates": [30.2672, -97.7431],
  "logo_url": "https://.../logo.png",
  "major_category0": "Healthcare",
  "minor_category0": "Nursing",
  "benefit_details": ["healthcare", "retirement"],
  "salary_details": { "min": 70000, "max": 95000, "period": "year" },
  "skills_details": ["patient care", "BLS"],
  "worktype_details": ["fulltime"]
}
```

### Do I need an API key?

Yes - your own **Talroo Publisher credentials**: a Publisher ID and a Publisher Password. This actor calls the Talroo job search API on your behalf, which requires those credentials. Join the Talroo Publisher Program at talroo.com/publish, then paste your Publisher ID and Password into the input and run. 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 Talroo Job Search API?

Talroo is a talent-attraction platform whose job search API returns active job listings from its network as structured data - title, company, location, salary, benefits and apply link. It lets you build job boards, run labor-market research or feed hiring data into your own tools without scraping.

#### What filters can I use?

Keywords (matched against job title and description), location (city and state or ZIP), search radius in kilometers, maximum commute in minutes, minimum and maximum salary, benefits (healthcare, pto, education, childcare, retirement) and work type (fulltime, parttime, internship, workfromhome, gig, entrylevel, noexperience). You can also request full descriptions.

#### Do I need credentials?

Yes. You supply your own Talroo Publisher ID and Publisher Password, obtained free by joining the Talroo Publisher Program at talroo.com/publish. The actor never ships shared credentials - you bring your own.

#### How many results per run?

Up to 1,000 jobs per run, paged automatically. For larger pulls, split by keyword, location or salary band, or run on a schedule and collect new listings each day.

#### How much does it cost?

Pricing is pay-per-result: a small fixed amount per job returned, plus standard Apify platform usage. A run that returns nothing costs almost nothing. Your Talroo Publisher account itself is separate and managed by Talroo.

#### 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 Talroo search API, retrieved through your own licensed Publisher account. No login-walled or personal data is collected.

### Keyword map

talroo api, talroo job search api, job search api, jobs api, job listings api, recruitment data api, job board api, employment data api, job postings api, hiring data api, job feed api, us 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

## `keywords` (type: `string`):

Search terms matched against the job title and description, e.g. `registered nurse`, `warehouse associate`. Provide keywords, a location, or both.

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

City and state (e.g. `Austin, TX`) or a ZIP code (e.g. `78701`). Provide keywords, a location, or both.

## `radiusKm` (type: `string`):

Distance around the location to include, in kilometers. Only used when a location is set.

## `maxCommuteMinutes` (type: `string`):

Maximum commute time from the location, in minutes. An alternative to the radius filter.

## `salaryMin` (type: `integer`):

Only return jobs with a salary at or above this amount.

## `salaryMax` (type: `integer`):

Only return jobs with a salary at or below this amount.

## `benefits` (type: `array`):

Filter to jobs that mention these benefits. Allowed values: healthcare, pto, education, childcare, retirement.

## `workTypes` (type: `array`):

Filter by type of work. Allowed values: fulltime, parttime, internship, workfromhome, gig, entrylevel, noexperience.

## `fullDescription` (type: `boolean`):

Return the complete job description for each listing instead of a short snippet.

## `maxResults` (type: `integer`):

Stop after this many jobs (1-1,000). You are charged per result returned.

## `publisherId` (type: `string`):

Your Talroo Publisher ID (an integer). Required. Obtained by joining the Talroo Publisher Program at talroo.com/publish.

## `apiKey` (type: `string`):

Your Talroo Publisher Password. Required. Stored securely and never logged.

## Actor input object example

```json
{
  "fullDescription": true,
  "maxResults": 100
}
```

# Actor output Schema

## `results` (type: `string`):

One row per result. Search the Talroo job network and export structured job listings - title, company, location, salary, benefits and apply link - filtered by keyword, location, radius, work type and benefits.

# 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 = {
    "keywords": "",
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("nabeelbaghoor/talroo-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": "",
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("nabeelbaghoor/talroo-job-search-api").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 '{
  "keywords": "",
  "maxResults": 100
}' |
apify call nabeelbaghoor/talroo-job-search-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nabeelbaghoor/talroo-job-search-api"
        }
    }
}

```

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/dcc05Laf7WbqT9xBQ/builds/GowsMWeadxNRS0iTS/openapi.json