# searchHackerNewsHiringPosts

**Identifier:** `hackernews_searchHackerNewsHiringPosts`

**Provider:** [Hacker News](https://kirha.com/providers/hackernews.md)

Search the monthly Hacker News "Who is hiring?", "Who wants to be hired?" and freelancer threads by keyword (stack, location, remote, company). Use it to find tech job openings or available engineers posted directly by companies and candidates.

## Run it with the CLI

```bash
kirha tools run hackernews_searchHackerNewsHiringPosts \
  --input '{
    "query": "rust remote europe"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "hackernews_searchHackerNewsHiringPosts",
  "input": {
    "query": "rust remote europe"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "default": 15,
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "month": {
      "description": "Thread month as YYYY-MM, latest by default",
      "pattern": "^\\d{4}-\\d{2}$",
      "type": "string"
    },
    "query": {
      "description": "Keywords, all must match, e.g., rust remote europe",
      "minLength": 2,
      "type": "string"
    },
    "thread": {
      "default": "hiring",
      "enum": [
        "hiring",
        "seekers",
        "freelance"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "posts": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "author": {
            "type": "string"
          },
          "headline": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "postedAt": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "threadId": {
      "type": "string"
    },
    "threadTitle": {
      "type": "string"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "threadId",
    "threadTitle",
    "total",
    "posts"
  ],
  "type": "object"
}
```

-----

[All Hacker News tools](https://kirha.com/providers/hackernews.md) · [< Back to tools list](https://kirha.com/tools.md)