Skip to main content
Hacker News logo
  • Category: news & lifestyle
  • Auth: NO_AUTH
  • Composio-managed OAuth available? N/A
  • Tools: 14
  • Triggers: 0
  • Slug: HACKERNEWS
  • Version: 20261101_00

Tools

Slug: HACKERNEWS_GET_ASK_STORIESGet up to 200 latest Ask HN story IDs from Hacker News. Returns an array of item IDs for Ask HN posts in ranked order.

Input Parameters

string ("pretty")
Output format for JSON response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_BEST_STORIESGet up to 500 best story IDs from HackerNews ranked by score. Returns story IDs only. Use the returned IDs with get_item_with_id action to fetch full story details.

Input Parameters

string ("pretty")
Output formatting options for the API response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_ITEMTool to get a Hacker News item by its unique ID from the Firebase API. Use when you need to retrieve details about a specific story, comment, job, poll, or pollopt.

Input Parameters

integer
required
The unique integer ID of the item (story, comment, job, poll, or pollopt) to retrieve from Hacker News.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_ITEM_WITH_IDGet a specific item from Hacker News using its ID. Limits response size to prevent context overflow.

Input Parameters

string
required
The unique numeric ID of the Hacker News item (story, comment, job, poll, or pollopt). Can be obtained from other HN API endpoints like search or front page.
integer
Maximum depth of nested comment replies to include. 0 means no children, 1 means direct replies only, 2 means replies to replies, etc. Default is 2.
integer
Maximum number of direct child comments to include in the response. Higher values return more comments but increase response size. Default is 10.
boolean
Whether to truncate long text content (comments, story text) to 500 characters. Set to False to get full text. Default is True to prevent context overflow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_JOB_STORIESGet up to 200 latest job story IDs from Hacker News. Returns an array of item IDs for job postings that can be used to fetch full job details.

Input Parameters

string
Set to ‘pretty’ for formatted JSON output. If not specified, returns compact JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_LATEST_POSTSGet the latest posts from Hacker News based on optional filters. Results can be limited using the size parameter.

Input Parameters

integer
Page number for pagination (0-indexed). Default is 0.
integer
Maximum number of results to return. Default is 5. Set to 0 or None to return all results from the page (up to 20 per page).
array
Tags to filter posts. Multiple tags are ANDed. Available tags: story, comment, poll, pollopt, show_hn, ask_hn, front_page, author_<USERNAME>, story_<ID>. Example: [‘story’] for stories only, [‘comment’, ‘story_12345’] for comments on story 12345.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_MAX_ITEM_IDTool to get the current largest item ID from Hacker News. Use when you need to discover the most recent items or iterate through all items in the system by walking backward from this ID.

Input Parameters

string
Set to ‘pretty’ for formatted JSON output. Leave unset for compact JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_NEW_STORIESGet up to 500 newest story IDs from Hacker News. Returns an array of item IDs sorted by recency (most recent first). Use these IDs with the Get Item action to retrieve full story details.

Input Parameters

string
Set to ‘pretty’ for formatted JSON output. Leave empty for compact JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_SHOW_STORIESTool to retrieve up to 200 latest Show HN story IDs from Hacker News. Use when you need to find recent Show HN posts where people share their projects, products, or creations.

Input Parameters

string
Set to ‘pretty’ for formatted JSON output. Leave empty for compact JSON.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_TOP_STORIESGet up to 500 top story IDs from HackerNews including jobs. Returns story IDs sorted by front page position. Use the returned IDs with get_item_with_id action to fetch full story details.

Input Parameters

string ("pretty")
Output formatting options for the API response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_UPDATESGet IDs of recently changed Hacker News items and usernames of recently changed user profiles. Use these to monitor recent activity or updates.

Input Parameters

string
Set to ‘pretty’ for formatted JSON output. Leave unset for compact output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_USERRetrieve a Hacker News user’s public profile by their username. Returns the user’s username, karma score, and optional bio/about text. Use this to look up information about HN community members.

Input Parameters

string
required
The case-sensitive username of the Hacker News user to retrieve (e.g., ‘pg’, ‘dang’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_GET_USER_BY_USERNAMETool to get a user profile by their case-sensitive username from the HackerNews Firebase API. Use when you need detailed user information including creation date, karma, bio, and submission history. Only users with public activity are available.

Input Parameters

string
required
The case-sensitive username of the Hacker News user to retrieve. Only users with public activity (comments or story submissions) are available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HACKERNEWS_SEARCH_POSTSSearch Hacker News posts using full-text search powered by Algolia. Use this action to find stories, comments, and discussions on Hacker News matching specific keywords. Supports filtering by post type (story, comment, show_hn, ask_hn) and by author.

Input Parameters

integer
Page number for pagination (0-indexed).
integer
Maximum number of results to return. Default is 5. Set to None or 0 to return all results from the page (up to 20).
array
Filter by tag types. Multiple list entries use AND logic. Available tags: story, comment, poll, pollopt, show_hn, ask_hn, front_page, author_<USERNAME> (e.g., author_pg), story_<ID> (e.g., story_123456).
string
required
Full-text search query. Supports AND, OR, NOT operators.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not