Hacker News Integration

search_stories — Search Hacker News stories by keyword. Returns matching stories with titles, links, and metadata.

Parameters

string

Keyword to search for in story titles. Leave empty to get all new stories. (Default: “)

integer

Maximum number of stories to return (1-50) (Default: 10)

integer

Minimum points threshold for stories

integer

Minimum comments threshold for stories

Response

{
  "$defs": {
    "HNRSSItem": {
      "additionalProperties": false,
      "properties": {
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "link": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Link"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "pub_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pub Date"
        },
        "guid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Guid"
        },
        "author": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Author"
        },
        "comments_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Comments Url"
        }
      },
      "title": "HNRSSItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "$ref": "#/$defs/HNRSSItem"
      },
      "title": "Stories",
      "type": "array"
    },
    "comments": {
      "items": {
        "$ref": "#/$defs/HNRSSItem"
      },
      "title": "Comments",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "keyword": {
      "default": "",
      "title": "Keyword",
      "type": "string"
    },
    "source": {
      "default": "hnrss.org",
      "title": "Source",
      "type": "string"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchOutput",
  "type": "object"
}

search_comments — Search Hacker News comments by keyword. Find discussions mentioning specific topics.

Parameters

string

Keyword to search for in comments. Leave empty to get all new comments. (Default: “)

integer

Maximum number of comments to return (1-50) (Default: 10)

Response

{
  "$defs": {
    "HNRSSItem": {
      "additionalProperties": false,
      "properties": {
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Title"
        },
        "link": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Link"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "pub_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pub Date"
        },
        "guid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Guid"
        },
        "author": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Author"
        },
        "comments_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Comments Url"
        }
      },
      "title": "HNRSSItem",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "$ref": "#/$defs/HNRSSItem"
      },
      "title": "Stories",
      "type": "array"
    },
    "comments": {
      "items": {
        "$ref": "#/$defs/HNRSSItem"
      },
      "title": "Comments",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "keyword": {
      "default": "",
      "title": "Keyword",
      "type": "string"
    },
    "source": {
      "default": "hnrss.org",
      "title": "Source",
      "type": "string"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchOutput",
  "type": "object"
}

get_top_stories — Get the current top stories from the Hacker News front page.

Parameters

integer

Number of stories to return (1-100) (Default: 10)

boolean

Whether to fetch full story details or just IDs (Default: true)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Stories",
      "type": "array"
    },
    "story_ids": {
      "items": {
        "type": "integer"
      },
      "title": "Story Ids",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Type"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetStoriesOutput",
  "type": "object"
}

get_new_stories — Get the newest stories submitted to Hacker News.

Parameters

integer

Number of stories to return (1-100) (Default: 10)

boolean

Whether to fetch full story details or just IDs (Default: true)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Stories",
      "type": "array"
    },
    "story_ids": {
      "items": {
        "type": "integer"
      },
      "title": "Story Ids",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Type"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetStoriesOutput",
  "type": "object"
}

get_best_stories — Get the highest-ranked stories from Hacker News.

Parameters

integer

Number of stories to return (1-100) (Default: 10)

boolean

Whether to fetch full story details or just IDs (Default: true)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Stories",
      "type": "array"
    },
    "story_ids": {
      "items": {
        "type": "integer"
      },
      "title": "Story Ids",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Type"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetStoriesOutput",
  "type": "object"
}

get_ask_stories — Get 'Ask HN' stories where users ask questions of the community.

Parameters

integer

Number of stories to return (1-100) (Default: 10)

boolean

Whether to fetch full story details or just IDs (Default: true)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Stories",
      "type": "array"
    },
    "story_ids": {
      "items": {
        "type": "integer"
      },
      "title": "Story Ids",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Type"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetStoriesOutput",
  "type": "object"
}

get_show_stories — Get 'Show HN' stories where users showcase projects and creations.

Parameters

integer

Number of stories to return (1-100) (Default: 10)

boolean

Whether to fetch full story details or just IDs (Default: true)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Stories",
      "type": "array"
    },
    "story_ids": {
      "items": {
        "type": "integer"
      },
      "title": "Story Ids",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Type"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetStoriesOutput",
  "type": "object"
}

get_job_stories — Get job postings from Hacker News.

Parameters

integer

Number of stories to return (1-100) (Default: 10)

boolean

Whether to fetch full story details or just IDs (Default: true)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "stories": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Stories",
      "type": "array"
    },
    "story_ids": {
      "items": {
        "type": "integer"
      },
      "title": "Story Ids",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Type"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetStoriesOutput",
  "type": "object"
}

get_item — Get details of a specific Hacker News item by ID (story, comment, poll, etc.).

Parameters

integer

required

The ID of the item to fetch

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "item": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Item"
    },
    "item_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Item Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetItemOutput",
  "type": "object"
}

get_user — Get a Hacker News user's profile including karma, about text, and submitted items.

Parameters

string

required

The HN username to look up

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "user": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "User"
    },
    "username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Username"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetUserOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Hacker News Integration for AI Agents & Workflows

Overview

Authentication

ModuleX Managed Key

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Hootsuite

LinkedIn

Pinterest

Links

​Overview

​Authentication

​ModuleX Managed Key

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Hootsuite

LinkedIn

Pinterest

​Links

Overview

Authentication

ModuleX Managed Key

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links