Home / Docs / Hacker News

Hacker News

Endpoints for Hacker News post tracking.

Hacker News

Create Hacker News Post

POST /api/hackernews-posts/

Auth: full_access

Record a new Hacker News submission linked to a company.

Request body:

{
  "url": "https://example.com/blog/announcement",
  "submission_url": "https://news.ycombinator.com/item?id=12345",
  "title": "Example announces new feature",
  "author": "hn_user",
  "points": 150,
  "post_date": "2025-01-15",
  "company_slug": "example"
}

Required fields: url, submission_url, title, author, company_slug

Optional fields: points, post_date (defaults to today)


List Hacker News Posts

GET /api/hackernews-posts/<company_slug>/

Auth: read_only or full_access

Returns Hacker News posts for a company.

Query parameters:

Parameter Type Description
submission_id string Filter by HN submission ID

Get Latest Hacker News Post

GET /api/hackernews-posts/<company_slug>/latest/

Auth: read_only or full_access

Returns the most recent Hacker News post for the company.


Update Hacker News Post

PUT / PATCH /api/hackernews-posts/<company_slug>/<submission_id>/

Auth: full_access

Update a Hacker News post by company slug and submission ID. Uses PATCH for partial updates.