# Jobthai Jobs Search Scraper (`alexist/jobthai-jobs-search-scraper`) Actor

Scrape Thai job search results from JobThai.com with custom filters by job type, keyword, province, and more. Extract 19+ fields including salaries, company info, and locations — perfect for recruiters, market researchers, and job aggregators.

- **URL**: https://apify.com/alexist/jobthai-jobs-search-scraper.md
- **Developed by:** [Alex](https://apify.com/alexist) (community)
- **Categories:** Automation, Developer tools, Jobs
- **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 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

## JobThai Jobs Search Scraper: Harvest Thai Job Listings at Scale

***

### What Is JobThai.com?

JobThai.com is Thailand's leading job search platform, connecting job seekers with thousands of employers across industries. It hosts listings from multinational corporations to local SMEs, covering roles in IT, hospitality, manufacturing, finance, and more. Manually collecting job data from search results is tedious and error-prone — the **JobThai Jobs Search Scraper** automates bulk data extraction, letting you gather market intelligence and build recruitment datasets efficiently.

***

### Overview

The **JobThai Jobs Search Scraper** extracts job listings from JobThai search results pages with advanced filtering capabilities. Unlike scraping individual job pages, this tool collects from search result sets, enabling you to:

- **Gather bulk data** — Extract hundreds of jobs per URL with a single run
- **Apply filters** — Target specific job types, keywords, and regions
- **Sort intelligently** — Use JobThai's built-in ordering (relevance, date, salary)
- **Build talent pools** — Collect competitive intelligence or recruitment databases

Perfect for recruiters, HR teams, researchers, and job aggregation platforms seeking structured Thai labor market data.

***

### Input Format

The scraper accepts search result URLs from JobThai with optional filtering:

```json
{
  "urls": [
    "https://www.jobthai.com/th/jobs?jobtype=7%2C2%2C30%2C28%2C4&keyword=AI&orderBy=RELEVANCE_SEARCH&page=2"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true
}
```

| Parameter | Description | Example |
|---|---|---|
| `urls` | JobThai job search result pages (array of URLs) | Search with filters: job types, keywords, location, sorting |
| `max_items_per_url` | Maximum jobs extracted per URL (1–200) | `200` = all available results |
| `ignore_url_failures` | Continues if a URL fails instead of stopping | `true` recommended for batch runs |

**URL structure:**

- `jobtype=7%2C2%2C30%2C28%2C4` → Job type filters (IT, HR, Sales, etc.)
- `keyword=AI` → Search term (e.g., "AI", "Developer", "Manager")
- `orderBy=RELEVANCE_SEARCH` → Sort method (relevance, date, salary)
- `page=2` → Results page number

> **Tip:** Build filtered URLs on JobThai.com, then paste them here. The scraper respects all filters applied in the URL.

***

### Output Format

**Example output record:**

```json
{
  "id": 1928407,
  "company_id": null,
  "job_title": "Sales Executive (AI Solution)",
  "company_name": "ASCGroup",
  "company_logo": "logo-pic-map/149864_logo_20240201114827.jpeg",
  "province": {
    "id": "01",
    "name": "กรุงเทพมหานคร"
  },
  "district": {
    "id": "0145",
    "name": "สาทร"
  },
  "industrial": {
    "id": null,
    "name": null
  },
  "disabled_person": {
    "id": 1,
    "name": "ไม่ต้องการระบุ"
  },
  "country": {
    "id": null,
    "name": null
  },
  "transit_stations": [],
  "is_top_company": false,
  "work_location": "",
  "salary": "ตามตกลง",
  "urgent": {
    "id": 2,
    "name": "Urgently Required"
  },
  "job_type": {
    "id": 4,
    "name": "งานขาย"
  },
  "region": {
    "id": "6",
    "name": "กรุงเทพและปริมณฑล"
  },
  "tags": [],
  "updated_at": "2026-07-17T10:16:53.000Z",
  "from_url": "https://www.jobthai.com/th/jobs?jobtype=7%2C2%2C30%2C28%2C4&keyword=AI&orderBy=RELEVANCE_SEARCH&page=2"
}
```

Each job listing returns a structured record with 19 core fields:

#### Identification & Metadata

| Field | Meaning |
|---|---|
| `ID` | Unique JobThai identifier for the job listing |
| `Company ID` | Unique identifier for the employer company |
| `Job Title` | Official job title as displayed (e.g., "Senior Python Developer") |
| `Company Name` | Employer company name |
| `Company Logo` | URL to the company's logo image |

#### Location & Geography

| Field | Meaning |
|---|---|
| `Province` | Thai province where the role is located (e.g., Bangkok, Chiang Mai) |
| `District` | District/sub-province level detail |
| `Country` | Country code (typically "TH" for Thailand, or international for remote) |
| `Work Location` | Specific work location or office address |
| `Transit Stations` | Nearby BTS/MRT stations for commute reference |
| `Region` | Broader region classification (Central, North, Northeast, South) |

#### Job Details

| Field | Meaning |
|---|---|
| `Job Type` | Employment type (full-time, part-time, contract, temporary) |
| `Industrial` | Industry/sector classification (IT, Hospitality, Manufacturing, etc.) |
| `Salary` | Monthly salary range in Thai Baht (e.g., "25,000 - 50,000") |
| `Urgent` | Boolean flag indicating if the position is urgently hiring |
| `Tags` | Skill tags or job attributes (e.g., \["English Required", "Remote OK"]) |

#### Special Attributes

| Field | Meaning |
|---|---|
| `Is Top Company` | Flag indicating if the employer is a verified "Top Company" on JobThai |
| `Disabled Person` | Flag indicating if the role is specifically for persons with disabilities |
| `Updated At` | Timestamp of when the listing was last updated |

***

### How to Use

1. **Build your search** — Go to JobThai.com, apply filters (job type, keyword, location, salary), and copy the resulting URL.
2. **Paste URLs** — Add one or multiple URLs to the `urls` array. You can run across multiple search pages or filter combinations.
3. **Set item limit** — Use `max_items_per_url` (1–200). Start with `100` for test runs; use `200` for production.
4. **Enable fault tolerance** — Set `ignore_url_failures: true` for robust batch scraping.
5. **Start the scraper** — Run the actor and monitor progress in the logs.
6. **Download results** — Export as JSON, CSV, or Excel for analysis.

**Best practices:**

- Separate runs by job type or keyword for organized datasets
- Use `orderBy=DATE_CREATED` to capture newly posted jobs
- Combine with `max_items_per_url: 200` to capture full result sets per page
- Test one URL first before scaling to 10+ URLs

***

### Use Cases & Business Value

- **Talent acquisition** — Build recruitment pipelines by scraping jobs matching your target profiles
- **Salary benchmarking** — Analyze compensation trends across Thai industries and locations
- **Market intelligence** — Track hiring volume and demand for specific skills (AI, DevOps, etc.)
- **Job aggregation platforms** — Feed JobThai listings into multi-source job boards
- **Academic research** — Study Thai labor market structure, geographic demand, and industry trends

By automating data collection, you save dozens of hours per week and build datasets that drive smarter hiring and business decisions.

***

### Conclusion

The **JobThai Jobs Search Scraper** is an efficient tool for anyone needing structured Thai job market data. Whether you're a recruiter building pipelines, a researcher studying labor trends, or a platform aggregating jobs, this scraper delivers clean, actionable records from one of Thailand's largest job boards. Start today and unlock insights hidden in thousands of listings.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Jobs list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.jobthai.com/th/jobs?jobtype=7%2C2%2C30%2C28%2C4&keyword=AI&orderBy=RELEVANCE_SEARCH&page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.jobthai.com/th/jobs?jobtype=7%2C2%2C30%2C28%2C4&keyword=AI&orderBy=RELEVANCE_SEARCH&page=2"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/jobthai-jobs-search-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 = {
    "urls": ["https://www.jobthai.com/th/jobs?jobtype=7%2C2%2C30%2C28%2C4&keyword=AI&orderBy=RELEVANCE_SEARCH&page=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/jobthai-jobs-search-scraper").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 '{
  "urls": [
    "https://www.jobthai.com/th/jobs?jobtype=7%2C2%2C30%2C28%2C4&keyword=AI&orderBy=RELEVANCE_SEARCH&page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 100
}' |
apify call alexist/jobthai-jobs-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=alexist/jobthai-jobs-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/0Cgi0XXILqRJeuf1X/builds/T6UlptTKRsBQZumsp/openapi.json