# Hacker News Who's Hiring Jobs Scraper (`parseforge/hn-whoishiring-scraper`) Actor

Parse the monthly Ask HN: Who is hiring? threads into structured job postings. Returns company, role, location, remote/onsite/hybrid, salary, visa support, full tech stack detection, employment type, and HN comment URL. Filter by month, keyword, remote-only, salary, or stack.

- **URL**: https://apify.com/parseforge/hn-whoishiring-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Jobs, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $15.00 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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 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)

## 💼 Hacker News Who's Hiring Jobs Scraper

> 🚀 **Parse the monthly Ask HN: Who is hiring? threads into structured job postings with company, role, salary, location, remote, visa, and stack auto-detected.**

> 🕒 **Last updated:** 2026-05-06 · **📊 22 fields** per record · **Hundreds of jobs per month** · auto-detected stack · salary ranges parsed · remote/onsite/hybrid flags · visa support detection

The **Hacker News Who's Hiring Jobs Scraper** parses the monthly *Ask HN: Who is hiring?* threads into structured job postings. Output includes company, role, location, remote/onsite/hybrid flags, salary range with currency, visa-support detection, employment type, full description, and a direct link to the original HN comment.

Each *Who's Hiring* thread carries hundreds of top-level comments, each posted by a hiring manager with a structured `Company | Role | Location | Type | Salary | Visa` header. The Actor parses every comment, auto-detects 60+ tech stacks (Python, Rust, React, AWS, LLMs, Web3), and lets you filter by keyword, remote-only, salary minimum, or specific stack.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Recruiters, hiring managers, job seekers, salary-research analysts, dev-tool marketers, NLP/ML pipelines | Job-market intelligence, salary benchmarking, recruiting candidate sourcing, dev-tool ICP mapping, content marketing on hiring trends |

---

### 📋 What the Hacker News Who's Hiring Jobs Scraper does

Five filtering workflows in a single run:

- 📅 **Pick any month.** `2026-05` for May 2026, or `current` for the latest available thread.
- 🔍 **Keyword filter.** Match across role, company, stack, and description.
- 🌍 **Remote-only filter.** Restrict to postings tagged remote (excluding onsite-only flags).
- 💰 **Salary minimum.** Filter to jobs with parsed salaries at or above a USD threshold.
- 🛠️ **Stack filter.** Match jobs mentioning a specific technology (Python, Rust, React, LLM).

> 💡 **Why it matters:** clean, server-side filtering removes the parser-and-pagination work from your team and keeps your dataset fresh on every run.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free plan caps at 10, paid plan up to 1,000,000.</td></tr>
<tr><td><code>month</code></td><td>string</td><td><code>"current"</code></td><td>`YYYY-MM` or `current` for the latest thread.</td></tr>
<tr><td><code>keyword</code></td><td>string</td><td><code>""</code></td><td>Free-text filter applied to each parsed job.</td></tr>
<tr><td><code>remoteOnly</code></td><td>boolean</td><td><code>false</code></td><td>Only return jobs tagged remote.</td></tr>
<tr><td><code>minSalary</code></td><td>integer</td><td><code>0</code></td><td>Minimum parsed salary (USD).</td></tr>
<tr><td><code>stack</code></td><td>string</td><td><code>""</code></td><td>Filter to jobs mentioning a specific stack.</td></tr>
</tbody>
</table>

**Example: all current Senior + Remote roles.**

```json
{
    "maxItems": 100,
    "month": "current",
    "keyword": "senior",
    "remoteOnly": true
}
````

**Example: Python jobs paying $150k+ in May 2026.**

```json
{
    "maxItems": 200,
    "month": "2026-05",
    "stack": "Python",
    "minSalary": 150000
}
```

***

### 📊 Output

Each record contains **22 fields**. Download the dataset as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 🏢 `company` | string | `"Pathos AI"` |
| 👤 `role` | string | `"Senior Software / AI Engineer"` |
| 📍 `location` | string | null | `"NYC (hybrid, 3-4 days onsite)"` |
| 🌍 `remote` | boolean | `false` |
| 🏢 `onsite` | boolean | `true` |
| 🏢 `hybrid` | boolean | `true` |
| 📋 `employmentType` | string | null | `"Full-time"` |
| 💰 `salaryRaw` | string | null | `"$180-200K"` |
| 💰 `salaryMin` | number | null | `180000` |
| 💰 `salaryMax` | number | null | `200000` |
| 💰 `salaryCurrency` | string | null | `"USD"` |
| 🛂 `visa` | boolean | `true` |
| 🛠️ `stack` | array | `["Python","TypeScript","BigQuery","GCP","LLM","OpenAI"]` |
| 📝 `descriptionText` | string | `"Pathos is an oncology biotech..."` |
| 📅 `threadMonth` | string | `"2026-05"` |
| 👤 `hnUser` | string | `"founder123"` |
| 🔗 `hnCommentUrl` | string | `"https://news.ycombinator.com/item?id=47975572"` |
| 📅 `postedAt` | ISO 8601 | `"2026-05-01T16:00:00Z"` |

#### 📦 Sample records

<details>
<summary><strong>🤖 AI biotech NYC hybrid</strong></summary>

```json
{"company":"Pathos AI","role":"Senior Software / AI Engineer","location":"NYC (hybrid, 3-4 days onsite)","remote":false,"hybrid":true,"employmentType":"Full-time","salaryRaw":"$180-200K","salaryMin":180000,"salaryMax":200000,"salaryCurrency":"USD","visa":true,"stack":["Python","TypeScript","BigQuery","GCP","LLM","OpenAI"]}
```

</details>

<details>
<summary><strong>🌐 Remote Python</strong></summary>

```json
{"company":"INDATA","role":"AI Development Associate","location":"REMOTE (US) or San Diego","remote":true,"salaryRaw":"$95,000–$115,000","salaryMin":95000,"salaryMax":115000,"stack":["Python","React","FastAPI","Redis","Azure","OpenAI","Anthropic","Claude"]}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🛠️ | **Auto-stack detection.** 60+ tech keywords scanned per posting (languages, frameworks, clouds, AI providers). |
| 💰 | **Salary parsing.** Heuristic match on USD/EUR/GBP ranges and singletons; min/max extracted as numbers. |
| 🌐 | **Remote/onsite/hybrid.** Three boolean flags from contextual parsing. |
| 📅 | **Month-by-month archives.** Pull any historical Who's Hiring thread by `YYYY-MM` since 2011. |
| ⚡ | **Fast.** 100 jobs in under 30 seconds; 300+ in a few minutes. |

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ This Actor** | $5 free credit | **~300 jobs/month** | Live per run | month, keyword, remote, salary, stack | ⚡ 2 min |
| Manual HN scrolling | Free | Manual | Live | Read each | 🐢 Hours per month |
| Whoishiring.io | Free | Same source, web UI | Variable | Limited | 🕒 Manual export |
| LinkedIn / Indeed | Variable | Different audience | Live | Yes | 🐢 Account |

Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance.

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Go to the Hacker News Who's Hiring Jobs Scraper page on the Apify Store.
3. 🎯 **Set input.** Pick your filters and `maxItems`.
4. 🚀 **Run it.** Click **Start** and let the Actor collect your data.
5. 📥 **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 👔 Recruiters & Sourcers

- Build candidate-target lists by stack
- Track hiring velocity in your niche
- Identify companies hiring for your specialty
- Salary benchmarks for offer pitches

</td>
<td width="50%" valign="top">

#### 📊 Salary Research

- Track market salary ranges by role and stack
- Compare remote vs onsite premiums
- Year-over-year salary inflation
- Geo-based pay gap analysis

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🛒 Dev Tool Marketing

- Identify ICP companies hiring for your stack
- Spot hiring booms in target verticals
- Power partnership outreach
- Build custom landing pages by stack

</td>
<td width="50%" valign="top">

#### 🎯 Job Seekers

- Filter for visa-friendly, remote, your stack
- Surface high-quality jobs without scrolling
- Track follow-up commitments
- Build a pipeline of applications

</td>
</tr>
</table>

***

### 🔌 Automating Hacker News Who's Hiring Jobs Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Hourly, daily, or weekly refreshes keep downstream databases in sync automatically.

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Tech-labor-market research
- Salary inflation studies
- Remote work prevalence research
- Reproducible HN job snapshots

</td>
<td width="50%">

#### 🎨 Personal and creative

- Personal job-search dashboards
- Salary-tracking newsletters
- Side projects on hiring trends
- Hobbyist career planning

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Tech-job accessibility research
- Remote-work advocacy data
- Diversity and inclusion analysis
- Bootcamp outcome tracking

</td>
<td width="50%">

#### 🧪 Experimentation

- Train job-classification ML models
- Prototype salary-prediction features
- Test resume-job matching
- Build job-recommendation engines

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20HN%20Who%27s%20Hiring%20Jobs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20HN%20Who%27s%20Hiring%20Jobs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20HN%20Who%27s%20Hiring%20Jobs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20HN%20Who%27s%20Hiring%20Jobs%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### 🧩 How does it work?

Each month, Hacker News mods post 'Ask HN: Who is hiring?' as a thread. Top-level comments are job postings from individual companies. The Actor finds the right thread for the requested month, fetches every top-level comment, and parses each into a structured job record.

#### 📅 How far back does it go?

Who's Hiring threads have run monthly since April 2011. Any month from 2011 to current is searchable.

#### 📊 How many fields per record?

22, including company, role, location, remote/onsite/hybrid, salary range with currency, visa support, employment type, full description, stack, and HN comment URL.

#### 🛠️ How accurate is stack detection?

60+ tech keywords scanned by case-insensitive word boundary. Catches the major languages, frameworks, clouds, databases, and AI providers. False negatives possible for very niche or vague mentions.

#### 💰 Why is my salary minimum filter dropping jobs?

Salary parsing is heuristic. If a posting has no parseable salary header (e.g. 'competitive' or no header at all), `salaryMin` is null and won't match. Set `minSalary: 0` to keep them.

#### 🔁 Can I schedule runs?

Yes. Schedule it for the 1st of each month to auto-pull the new Who's Hiring thread.

#### ⚖️ Is this data public?

Yes. Hacker News content is publicly browsable. Only public posts are collected.

#### 💳 Do I need a paid Apify plan?

No. The free plan covers preview runs. A paid plan unlocks higher item counts and scheduling.

#### 🆘 What if a run fails?

Apify retries transient errors. Partial datasets are preserved.

#### 📅 What does `month: current` mean?

The latest available Who's Hiring thread, usually posted on the 1st of the current month.

***

### 🔌 Integrate with any app

Hacker News Who's Hiring Jobs Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes.

***

### 🔗 Recommended Actors

- [**📊 Stack Exchange Questions**](https://apify.com/parseforge/stackexchange-questions-scraper) - Search 170+ Stack Exchange sites
- [**💻 VS Code Marketplace**](https://apify.com/parseforge/vs-code-marketplace-scraper) - VS Code extensions catalog
- [**🎌 AniList Anime/Manga**](https://apify.com/parseforge/anilist-anime-manga-scraper) - Anime, manga, light novels
- [**📰 Hacker News Search (existing)**](https://apify.com/parseforge/hacker-news-scraper) - Stories, comments, users from HN
- [**📊 Greenhouse Jobs Scraper**](https://apify.com/parseforge/greenhouse-jobs-scraper) - Greenhouse-hosted company job pages

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Y Combinator, Hacker News, or any individual hiring company. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.

# Actor input Schema

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

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

## `month` (type: `string`):

Month in `YYYY-MM` format (e.g. `2026-05`), or `current` for the latest available thread.

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

Free-text search applied to each job posting (matches role, company, stack, description). Empty = all jobs.

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

When checked, returns only postings tagged remote.

## `minSalary` (type: `integer`):

Filter to jobs with a parsed salary at or above this number. Empty = no salary filter. Salary parsing is heuristic.

## `stack` (type: `string`):

Filter to jobs mentioning a specific stack (e.g. `Python`, `Rust`, `React`).

## Actor input object example

```json
{
  "maxItems": 10,
  "month": "current",
  "remoteOnly": false
}
```

# Actor output Schema

## `overview` (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,
    "month": "current",
    "keyword": "",
    "minSalary": 0,
    "stack": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/hn-whoishiring-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,
    "month": "current",
    "keyword": "",
    "minSalary": 0,
    "stack": "",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/hn-whoishiring-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,
  "month": "current",
  "keyword": "",
  "minSalary": 0,
  "stack": ""
}' |
apify call parseforge/hn-whoishiring-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Hacker News Who's Hiring Jobs Scraper",
        "description": "Parse the monthly Ask HN: Who is hiring? threads into structured job postings. Returns company, role, location, remote/onsite/hybrid, salary, visa support, full tech stack detection, employment type, and HN comment URL. Filter by month, keyword, remote-only, salary, or stack.",
        "version": "1.0",
        "x-build-id": "Eyo4KgM8g3gfqW0nn"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~hn-whoishiring-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-hn-whoishiring-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~hn-whoishiring-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-hn-whoishiring-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~hn-whoishiring-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-hn-whoishiring-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"
                    },
                    "month": {
                        "title": "Month",
                        "type": "string",
                        "description": "Month in `YYYY-MM` format (e.g. `2026-05`), or `current` for the latest available thread."
                    },
                    "keyword": {
                        "title": "Keyword filter",
                        "type": "string",
                        "description": "Free-text search applied to each job posting (matches role, company, stack, description). Empty = all jobs."
                    },
                    "remoteOnly": {
                        "title": "Remote-only",
                        "type": "boolean",
                        "description": "When checked, returns only postings tagged remote.",
                        "default": false
                    },
                    "minSalary": {
                        "title": "Minimum salary (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Filter to jobs with a parsed salary at or above this number. Empty = no salary filter. Salary parsing is heuristic."
                    },
                    "stack": {
                        "title": "Stack keyword",
                        "type": "string",
                        "description": "Filter to jobs mentioning a specific stack (e.g. `Python`, `Rust`, `React`)."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
