# Hacker News Who Is Hiring API. Who is hiring, on request.

Jobs from a month's Who is hiring thread. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dhackernews.whoishiring_jobs)

[In your agent: **Hacker News MCP server** →](https://socialtap.dev/mcp/hackernews/index.md)

## Hacker News Who Is Hiring API at a glance

Returns the jobs posted in Hacker News' monthly Ask HN: Who is hiring? thread, the latest or any month you pick, newest first. Each job has its company, title, locations, remote or onsite, employment type, salary range, visa sponsorship and apply link, plus its full text, poster and posting time.

GET `/v1/hackernews/whoishiring_jobs`

[Read the API reference](https://socialtap.dev/docs/reference/hackernews/whoishiring-jobs/index.md)

- **1 credit** per page, $0.75–$1.97 per 1,000 pages
- **23 typed fields** null when unknown
- **100** jobs per page, newest first
- **100 credits** free when you sign up, no card, so you can build before you spend

## Send one request. Get up to 100 jobs back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

`$ npm install socialtap`

[Open in playground](https://socialtap.dev/playground/?endpoint=hackernews.whoishiring_jobs)

cURL:

```shell
curl 'https://socialtap.dev/v1/hackernews/whoishiring_jobs' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.hackernews.whoishiringJobs.list({});
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
});
const res = await fetch(`https://socialtap.dev/v1/hackernews/whoishiring_jobs?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/hackernews/whoishiring_jobs",
    params={},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/hackernews/whoishiring_jobs?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": [
    {
      "apply_url": null,
      "approximate_fields": [
        "salary.period"
      ],
      "benefits": [],
      "description": "Early-stage Startup | Software Engineer & Data Analyst | Full-Time | REMOTE (US & US Citizen) | $100,000 - $180,000 USD\n\nWe’re hiring for two roles: a strong generalist Software Engineer and a Data Analyst.\n\nFor the Software Engineer role, we’re looking for someone with solid tec…",
      "employer": {
        "avatar_url": null,
        "display_name": "Early-stage Startup",
        "id": null,
        "is_verified": null,
        "url": null,
        "username": null
      },
      "employment_types": [
        "full_time"
      ],
      "expires_at": null,
      "id": "50500910",
      "industries": [],
      "is_closed": null,
      "is_easy_apply": false,
      "job_functions": [],
      "locations": [
        {
          "city": null,
          "country_code": null,
          "name": "US",
          "region": null
        }
      ],
      "metrics": {
        "applicant_count": null
      },
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "header": "Early-stage Startup | Software Engineer & Data Analyst | Full-Time | REMOTE (US & US Citizen) | $100,000 - $180,000 USD",
          "is_visa_sponsored": null,
          "poster": {
            "avatar_url": null,
            "display_name": null,
            "id": "Paulyonewaytech",
            "is_verified": null,
            "url": "https://news.ycombinator.com/user?id=Paulyonewaytech",
            "username": "Paulyonewaytech"
          },
          "thread": {
            "id": "50338728",
            "title": "Ask HN: Who is hiring? (November 2026)",
            "url": "https://news.ycombinator.com/item?id=50338728"
          }
        }
      },
      "published_at": "2026-11-14T21:17:20Z",
      "salary": {
        "currency": "USD",
        "is_estimated": false,
        "max": 180000,
        "min": 100000,
        "period": "year"
      },
      "seniority": null,
      "skills": [],
      "title": "Software Engineer & Data Analyst",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=50500910",
      "workplace_type": "remote"
    },
    {
      "apply_url": null,
      "approximate_fields": [],
      "benefits": [],
      "description": "SEEKING FREELANCE - Egypt (UTC+2, full EU/UK overlap) - Remote\n\nSenior Full-Stack & Creative Frontend Engineer (4+ yrs). I architect high-concurrency Next.js/TypeScript and Node/NestJS systems, Shopify Storefront/Fulfillment workflows, MCP AI pipelines, and 60fps WebGL/Three.js/G…",
      "employer": null,
      "employment_types": [
        "contract"
      ],
      "expires_at": null,
      "id": "50495944",
      "industries": [],
      "is_closed": null,
      "is_easy_apply": false,
      "job_functions": [],
      "locations": [
        {
          "city": null,
          "country_code": null,
          "name": "Egypt",
          "region": null
        }
      ],
      "metrics": {
        "applicant_count": null
      },
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "header": "SEEKING FREELANCE - Egypt (UTC+2, full EU/UK overlap) - Remote",
          "is_visa_sponsored": null,
          "poster": {
            "avatar_url": null,
            "display_name": null,
            "id": "noordragon2004",
            "is_verified": null,
            "url": "https://news.ycombinator.com/user?id=noordragon2004",
            "username": "noordragon2004"
          },
          "thread": {
            "id": "50338728",
            "title": "Ask HN: Who is hiring? (November 2026)",
            "url": "https://news.ycombinator.com/item?id=50338728"
          }
        }
      },
      "published_at": "2026-11-14T10:50:31Z",
      "salary": null,
      "seniority": null,
      "skills": [],
      "title": "SEEKING FREELANCE - Egypt (UTC+2, full EU/UK overlap) - Remote",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=50495944",
      "workplace_type": "remote"
    },
    {
      "apply_url": null,
      "approximate_fields": [
        "salary.period"
      ],
      "benefits": [],
      "description": "Common Prefix | Senior Software Engineer | Athens, Greece / REMOTE | Full-time | $80k to $160k + equity + bonus\n\nWe're hiring Senior Software Engineers!\n\nWe're a mix of scientists (professors, PhDs, and postdocs from Stanford, Imperial, ETH Zürich, and Edinburgh) and engineers wi…",
      "employer": {
        "avatar_url": null,
        "display_name": "Common Prefix",
        "id": null,
        "is_verified": null,
        "url": null,
        "username": null
      },
      "employment_types": [
        "full_time"
      ],
      "expires_at": null,
      "id": "50488627",
      "industries": [],
      "is_closed": null,
      "is_easy_apply": false,
      "job_functions": [],
      "locations": [
        {
          "city": null,
          "country_code": null,
          "name": "Athens, Greece",
          "region": null
        }
      ],
      "metrics": {
        "applicant_count": null
      },
      "platform": "hackernews",
      "platform_specific": {
        "hackernews": {
          "header": "Common Prefix | Senior Software Engineer | Athens, Greece / REMOTE | Full-time | $80k to $160k + equity + bonus",
          "is_visa_sponsored": null,
          "poster": {
            "avatar_url": null,
            "display_name": null,
            "id": "commonprefix",
            "is_verified": null,
            "url": "https://news.ycombinator.com/user?id=commonprefix",
            "username": "commonprefix"
          },
          "thread": {
            "id": "50338728",
            "title": "Ask HN: Who is hiring? (November 2026)",
            "url": "https://news.ycombinator.com/item?id=50338728"
          }
        }
      },
      "published_at": "2026-11-13T19:37:57Z",
      "salary": {
        "currency": "USD",
        "is_estimated": false,
        "max": 160000,
        "min": 80000,
        "period": "year"
      },
      "seniority": null,
      "skills": [],
      "title": "Senior Software Engineer",
      "unknown_fields": [],
      "url": "https://news.ycombinator.com/item?id=50488627",
      "workplace_type": "remote"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "hackernews",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1000,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": null,
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 2 platforms.

The [response reference](https://socialtap.dev/docs/reference/hackernews/whoishiring-jobs/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/job/index.md).

- ### Null means unknown

  A field Hacker News doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### No input needed

  Every parameter is optional: the plain request returns the default list.
- ### Write one parser

  Hacker News and LinkedIn answer in these fields, so the code that reads one reads them all.

- **`platform`string**: Platform ID (linkedin, …).
- **`id`string**: Platform-native job ID (string; LinkedIn's numeric job ID).
- **`url`string**: Canonical job page URL (https://www.linkedin.com/jobs/view/\<id>/).
- **`title`string**: The job's title as the employer wrote it.
- **`employer`object**: The company (or person) hiring, as the board names it: its account on the platform when it has one; null when the board does not say who is hiring (a confidential posting, an Upwork client).
- **`description`string**: The full description as plain text, line breaks kept (paragraphs and list items each on their own line); null when the board shows none.
- **`locations`object\[\]**: Where the job is based, the main location first, as the board shows them; \[\] when none is shown (a remote job with no location), listed in unknown_fields when the source cannot see them.
- **`workplace_type`string**: Where the work is done: on_site, hybrid (partly remote) or remote; null when the board does not say. New values may be added; treat unknown values as null.

Live data from 35 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [GitHub](https://socialtap.dev/apis/github/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Hacker News](https://socialtap.dev/apis/hackernews/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/page/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/profile/index.md) · [Linkme](https://socialtap.dev/apis/linkme/profile/index.md) · [Linktree](https://socialtap.dev/apis/linktree/profile/index.md) · [Pillar](https://socialtap.dev/apis/pillar/page/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## What teams build with the Hacker News Who Is Hiring API.

- ### Collect this month's remote Hacker News jobs
- ### Track which startups hire for which roles
- ### Compare Hacker News salaries across the years
- ### Find jobs that sponsor visas
- ### Feed new Hacker News jobs into alerts

## Good to know before you build.

- Company, title, locations, workplace_type, employment_types, salary and visa sponsorship are read from each job's first line, which most posters write as Company | Role | Location | REMOTE | Full-time | salary.
- When a first line doesn't follow that form, those fields are null or empty and title is the line itself; platform_specific.hackernews.header keeps the line as written.
- workplace_type is remote when a job offers remote work at all, hybrid when it says hybrid, and on_site when it names only onsite work.
- A salary written without its period is read as yearly when it is in the tens of thousands or more.
- apply_url is the job's link to a careers page, an applicant tracking system or a form; its other links stay in the description.
- Replies to jobs are not listed, and neither are jobs Hacker News removed or killed.
- Each month's thread is posted on its first weekday around 11:00 New York time, so until then the latest thread is last month's.

## 1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/hackernews/whoishiring-jobs/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful page | Per 1,000 pages |
| --- | --- | --- |
| Platform API `api` | 1 credit | $0.75–$1.97 |

- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

## Questions about the Hacker News Who Is Hiring API.

More in the [API reference](https://socialtap.dev/docs/reference/hackernews/whoishiring-jobs/index.md).

**How do I get only remote jobs?**

Every job has workplace_type: keep those whose value is remote. The first line decides it, so a job that says REMOTE or ONSITE counts as remote.

**Can I get an older month?**

Yes. Send month as YYYY-MM, for example month=2019-06, for any month from April 2011 on.

**How much does the Hacker News Who Is Hiring API cost?**

A page of up to 100 jobs costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

**How do I get the next page?**

Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours.

Other platforms

## Jobs on 1 more platform.

- [LinkedIn Job API](https://socialtap.dev/apis/linkedin/job/index.md) (1 credit · `GET /v1/linkedin/job`)

More Hacker News

## Hacker News API. 11 endpoints, one key.

- [Hacker News Story API](https://socialtap.dev/apis/hackernews/story/index.md) (1 credit · `GET /v1/hackernews/story`)
- [Hacker News Feed API](https://socialtap.dev/apis/hackernews/feed-stories/index.md) (1 credit / page · `GET /v1/hackernews/feed_stories`)
- [Hacker News Search API](https://socialtap.dev/apis/hackernews/search-stories/index.md) (1 credit / page · `GET /v1/hackernews/search_stories`)
- [Hacker News User Stories API](https://socialtap.dev/apis/hackernews/user-stories/index.md) (1 credit / page · `GET /v1/hackernews/user_stories`)
- [Hacker News User Favorites API](https://socialtap.dev/apis/hackernews/user-favorites/index.md) (1 credit / page · `GET /v1/hackernews/user_favorites`)
- [Hacker News User API](https://socialtap.dev/apis/hackernews/user/index.md) (1 credit · `GET /v1/hackernews/user`)
- [Hacker News Comment API](https://socialtap.dev/apis/hackernews/comment/index.md) (1 credit · `GET /v1/hackernews/comment`)
- [Hacker News Comments API](https://socialtap.dev/apis/hackernews/comments/index.md) (1 credit / page · `GET /v1/hackernews/comments`)
- [Hacker News User Comments API](https://socialtap.dev/apis/hackernews/user-comments/index.md) (1 credit / page · `GET /v1/hackernews/user_comments`)
- [Hacker News Comment Search API](https://socialtap.dev/apis/hackernews/search-comments/index.md) (1 credit / page · `GET /v1/hackernews/search_comments`)

## See what's on the list right now.

Run it in the playground, or copy the request into your code.

100free credits

- No credit card
- Failed requests are free
- Works on all 276 endpoints

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/hackernews/whoishiring-jobs/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
