---
title: "Hacker News API: JSON data, 4 endpoints, 1 credit per call"
description: "Get Hacker News data as structured JSON with one API key: search, item, stories and user. Free credits every month."
url: https://perceptlayer.com/apis/hacker-news
---

[APIs](https://perceptlayer.com/apis) / [Social media](https://perceptlayer.com/verticals/social) / Hacker News

1 credit per call 4 endpoints

# Hacker News API

Get Hacker News data as structured JSON with one API key: search, item, stories and user. Free credits every month.

[Get a free API key](https://perceptlayer.com/signup) Run it below

Hacker News

GET /v1/hacker-news/search?query=dishwasher&type=story 

```
curl "https://api.perceptlayer.com/v1/hacker-news/search?query=dishwasher&type=story" \
  -H "X-API-Key: $API_KEY"
```

cURL 1 credit per successful call

Run this call below or from your dashboard to see a live response.

Playground

## Run this API

cURL shell 

```
curl "https://api.perceptlayer.com/v1/hacker-news/search?query=dishwasher&type=story" \
  -H "X-API-Key: $API_KEY"
```

Hacker News · 4 endpoints

## Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

Note 

Endpoints marked “Needs terms” return personal or social data. They work once you accept the [restricted-endpoint terms](https://perceptlayer.com/legal/restricted-endpoints) in your dashboard.

| Endpoint | Required parameters | Cost |
| --- | --- | --- |
| [GET `/v1/hacker-news/item`](https://perceptlayer.com/apis/hacker-news/item) | `id` +1 optional Needs terms | 1 credit |
| [GET `/v1/hacker-news/search`](https://perceptlayer.com/apis/hacker-news/search) | `query` +6 optional Needs terms | 1 credit |
| [GET `/v1/hacker-news/stories`](https://perceptlayer.com/apis/hacker-news/stories) | none +3 optional Needs terms | 1 credit |
| [GET `/v1/hacker-news/user`](https://perceptlayer.com/apis/hacker-news/user) | `id` +1 optional Needs terms | 1 credit |

Overview

## About the Hacker News API

## What you can get

The Hacker News API returns search, item, stories and user as clean JSON. Each successful call costs one credit, and calls that fail are free.

Social media JSON REST MCP Some endpoints need terms

### More social media APIs

[Behance](https://perceptlayer.com/apis/behance) [Bilibili](https://perceptlayer.com/apis/bilibili) [Bluesky](https://perceptlayer.com/apis/bluesky) [Dailymotion](https://perceptlayer.com/apis/dailymotion) [DeviantArt](https://perceptlayer.com/apis/deviantart) [Dribbble](https://perceptlayer.com/apis/dribbble) [Facebook](https://perceptlayer.com/apis/facebook) [Facebook Ad Library](https://perceptlayer.com/apis/facebook-ad-library) [Flickr](https://perceptlayer.com/apis/flickr) [Imgur](https://perceptlayer.com/apis/imgur) [Instagram](https://perceptlayer.com/apis/instagram) [Kick](https://perceptlayer.com/apis/kick)

Use cases

### Monitor mentions of your product

`Use the Hacker News API to monitor mentions of your product` 

### Track top stories and discussions

`Use the Hacker News API to track top stories and discussions` 

### Research the stories that reach the front page

`Use the Hacker News API to research the stories that reach the front page` 

FAQ

## Questions

**How much does the Hacker News API cost?**

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

**What format are responses in?**

Every endpoint returns JSON, with no HTML parsing on your side.

**Do I need a separate key for Hacker News?**

No. One key works for every API in the catalogue.

## Try the Hacker News API with 1,000 free credits

No credit card. Failed calls are never billed.

[Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)