# ATS Jobs API – Hacker News Jobs Search

> ATS Jobs API – Hacker News Jobs Search is a paid API for AI agents from ats-jobs-api.groundtruthtools.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-01).

Search Hacker News job postings by keyword query or story IDs, returning structured job story metadata from the HN firehose.

## Facts

- Endpoint: GET https://ats-jobs-api.groundtruthtools.workers.dev/x402/v1/hacker-news?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ats-jobs-api-hacker-news-jobs-search-aa18cfb0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y-13y23xqNMSrQmIfIjR_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ats-jobs-api-hacker-news-jobs-search-aa18cfb0
```

Example prompt: Search Hacker News job postings for 'senior backend engineer remote' and show me the most relevant results posted since January 2024.

## When to prefer this

Choose this endpoint when you specifically need to search or retrieve job postings from Hacker News (the 'Who is Hiring' and related threads), especially when you want to query by keyword or retrieve specific story IDs. It is distinct from the ATS-backed endpoints on the same service that pull from Greenhouse/Ashby/Lever/Workable; use this endpoint for HN community job posts rather than corporate ATS listings.

## Known failure modes

- Empty results if query matches no HN job postings
- Invalid date_from format may return an error or no results
- Malformed or non-existent story_ids return empty items array
- Rate limiting or payment failure (x402) returns 402 Payment Required
- No salary data returned — this endpoint surfaces HN stories, not ATS job listings with structured salary fields

## How this service works

Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.

## Output

Returns a JSON object with a mode indicator ('search'), a count of matching items, and an array of job story objects each containing the HN story ID, URL, type, title, author, domain, points, source, creation timestamp, a verify URL linking to the original HN item, and a comment count. Also includes a notes array for any API-level notices.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "query": {
       "type": "string"
      },
      "date_from": {
       "type": "string"
      },
      "story_ids": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "search",
  "count": 1,
  "items": [
   {
    "id": 8863,
    "url": "http://www.getdropbox.com/u/2/screencast.html",
    "type": "story",
    "title": "My YC app: Dropbox - Throw away your USB drive",
    "author": "dhouston",
    "domain": "getdropbox.com",
    "points": 104,
    "source": "algolia",
    "created_at": "2007-04-04T19:16:40Z",
    "verify_url": "https://news.ycombinator.com/item?id=8863",
    "num_comments": 71
   }
  ],
  "notes": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ats-jobs-api-hacker-news-jobs-search-aa18cfb0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ats-jobs-api.groundtruthtools.workers.dev](https://www.zero.xyz/host/ats-jobs-api.groundtruthtools.workers.dev/llms.txt)