# Tealhq Job Board (`parseforge/tealhq-job-board-scraper`) Actor

Find active job listings from Tealhq Job Board with title, company, location, remote flag, posted date, salary when published and the direct apply link. Designed for recruiters, agencies, aggregator sites and job hunters. Run on demand or on a recurring schedule and feed every row into your favou.

- **URL**: https://apify.com/parseforge/tealhq-job-board-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 💼 Teal Job Board Scraper

> 🚀 **Pull tech jobs from Teal in seconds.** Browse by job title, skill, level, location or workplace type and get title, company, location, workplace, salary, career level and apply URL. tabular records.

> 🕒 **Last updated:** 2026-05-27 · **📊 19 fields** per record · Daily-refreshed · Tech-focused

Pulls Teal job listings directly from the public site by reading the embedded React Query state. Supports browse by title (e.g. `software-engineer`), by skill (e.g. `react`), by career level, by location and by workplace type.

---

### Target Audience / Use Cases

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Recruiters | Source tech candidates from Teal's curated listings |
| Job seekers | Watchlists by skill / title / level |
| Talent analysts | Hiring-demand benchmarks by role |
| Aggregator builders | Power tech-jobs products with structured data |
| HR Researchers | Salary band research across roles |

---

### 📋 What this scraper does

- Connects to the public Teal job board
- Pulls job listings from the chosen browse-by axis
- Returns structured rows ready for analysis
- Outputs tabular, tabular, spreadsheet, tabular

> 💡 **Why it matters:** Teal curates tech jobs with rich metadata - salary bands, career level, workplace type. Get it as a queryable dataset.

---

### 🎬 Full Demo

🚧 Coming soon

---

### ⚙️ Input

<table><thead><tr><th>Field</th><th>Type</th><th>Description</th></tr></thead><tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td>Free users: Limited to 10. Paid users: Optional, max 1,000,000.</td></tr>
<tr><td><code>browseBy</code></td><td>string</td><td><code>title</code>, <code>skill</code>, <code>level</code>, <code>location</code>, or <code>workplace</code>.</td></tr>
<tr><td><code>slug</code></td><td>string</td><td>URL slug. e.g. <code>software-engineer</code>, <code>react</code>, <code>senior</code>, <code>remote</code>.</td></tr>
</tbody></table>

```tabular
{ "maxItems": 5, "browseBy": "title", "slug": "software-engineer" }
````

```tabular
{ "maxItems": 25, "browseBy": "skill", "slug": "react" }
```

> ⚠️ **Good to Know:** Teal applies anti-bot controls. The actor uses residential proxies + a Chrome TLS fingerprint to keep success rates high.

***

### 📊 Output

Key fields: companyLogo, title, role, company, location, workplaceType, employmentType, careerLevels, minEducationLevel, industry, salaryMin, salaryMax, salaryCurrency, salaryPayPeriod, postedAt, url, sourceUrl, scrapedAt.

***

### ✨ Why choose this Actor

- 🟢 Backed by direct extraction from Teal's job board state
- 🟢 No login or API key required
- 🟢 Up to 1,000,000 records per paid run
- 🟢 Multiple pull shape

***

### 📈 How it compares to alternatives

| Option | Free | Bulk | Live |
|---|---|---|---|
| Source website | Yes | No | Yes |
| **ParseForge Scraper** | **Yes** | **Yes** | **Live** |

***

### 🚀 How to use

1. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp)
2. Open this actor in the Apify Console
3. Pick browse-by axis + slug
4. Click **Start** and wait for the run to finish
5. Open the dataset as tabular records

***

### 💼 Business use cases

- Tech-jobs aggregator data feed
- Salary-band benchmarking by role
- Sourcing pipeline for tech recruiters
- Daily tech-jobs newsletter automation

***

### 🔌 Automating Teal Job Board Scraper

Trigger runs from Make, Zapier, n8n, Airbyte, GitHub Actions, Google Sheets, Slack, Airtable or any HTTP client via the Apify API.

***

### 🌟 Beyond business use cases

- Labour-market academic research
- Personal job hunt with custom skill alerts
- Non-profit tech-talent programs
- Tech experimentation with hiring-trend datasets

***

### 🤖 Ask an AI assistant

Open the run URL with ChatGPT, Claude, Perplexity or Copilot for instant insights.

***

### ❓ Frequently Asked Questions

**Is this affiliated with Teal?** No, independent tool.
**Is login required?** No, only public data.
**How do I browse by skill?** Set `browseBy=skill` and `slug=react` (or `python`, etc.).
**Can I pull to spreadsheet?** Yes.
**Is the data live?** Yes, every run.
**Does it include salary bands?** Yes when Teal exposes them.
**Why residential proxies?** Teal applies bot-management to datacenter IPs.
**Can I filter by remote?** Set `browseBy=workplace` and `slug=remote`.
**What's the maximum number of records?** Up to 1,000,000 on paid plans.
**Does the actor follow detail pages?** No; the listing page already exposes structured per-job data.

***

### 🔌 Integrate with any app

Apify API works with REST, webhooks, Make, Zapier, Airbyte, n8n, Slack, Google Drive, GitHub, Airtable.

***

### 🔗 Recommended Actors

| Actor | What it does |
|---|---|
| [Google Maps Scraper](https://apify.com/compass/crawler-google-places) | Business listings from Google Maps |
| [LinkedIn Profile Scraper](https://apify.com/curious_coder/linkedin-profile-scraper) | Public LinkedIn profile data |
| [Indeed Scraper](https://apify.com/misceres/indeed-scraper) | Job listings from Indeed |

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge).

**🆘 Need Help?** [Open our contact form](https://tally.so/r/BzdKgA)

> **⚠️ Disclaimer:** independent tool, not affiliated with Teal. Only publicly available data collected.

# Actor input Schema

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `browseBy` (type: `string`):

How to navigate the Teal job board.

## `slug` (type: `string`):

URL slug under /jobs/<browseBy>/<slug>. Examples: 'software-engineer', 'product-manager', 'data-analyst' for title; 'react', 'python' for skill; 'senior', 'intern' for level; 'remote', 'hybrid' for workplace.

## Actor input object example

```json
{
  "maxItems": 10,
  "browseBy": "title",
  "slug": "software-engineer"
}
```

# Actor output Schema

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

No description

# 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 = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/tealhq-job-board-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 = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/tealhq-job-board-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 '{
  "maxItems": 10
}' |
apify call parseforge/tealhq-job-board-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/tealhq-job-board-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Tealhq Job Board",
        "description": "Find active job listings from Tealhq Job Board with title, company, location, remote flag, posted date, salary when published and the direct apply link. Designed for recruiters, agencies, aggregator sites and job hunters. Run on demand or on a recurring schedule and feed every row into your favou.",
        "version": "0.1",
        "x-build-id": "bhfLwTkL7SszX566F"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~tealhq-job-board-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-tealhq-job-board-scraper",
                "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/parseforge~tealhq-job-board-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-tealhq-job-board-scraper",
                "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/parseforge~tealhq-job-board-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-tealhq-job-board-scraper",
                "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": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "browseBy": {
                        "title": "Browse by",
                        "enum": [
                            "title",
                            "skill",
                            "level",
                            "location",
                            "workplace"
                        ],
                        "type": "string",
                        "description": "How to navigate the Teal job board.",
                        "default": "title"
                    },
                    "slug": {
                        "title": "Slug",
                        "type": "string",
                        "description": "URL slug under /jobs/<browseBy>/<slug>. Examples: 'software-engineer', 'product-manager', 'data-analyst' for title; 'react', 'python' for skill; 'senior', 'intern' for level; 'remote', 'hybrid' for workplace.",
                        "default": "software-engineer"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```