검색
1 크레딧/v1/hackernews/search질의와 맞는 스토리를 반환합니다. 제목, 링크, 작성자, 점수, 댓글 수, 게시 시각이 포함됩니다. tags로 댓글 등 다른 항목 유형까지 범위를 넓힐 수 있습니다.
query, tags, numericFilters, hitsPerPage, page
Hacker News APIHacker News 데이터 API
SocialCrawl API 키로 공개 Hacker News 검색 결과, 스토리, 댓글 트리, 프로필을 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.
/v1/hackernews
활성 엔드포인트는 4개입니다.
- GET /v1/hackernews/search
- GET /v1/hackernews/story
- GET /v1/hackernews/story/comments
- GET /v1/hackernews/profile
Hacker News 엔드포인트
공개 Hacker News 읽기 엔드포인트는 4개입니다. 키워드 검색, 단일 스토리, 중첩 댓글 트리, 사용자 프로필을 제공합니다. 데이터 API만 지원하며 투표, 제출, 비공개 계정은 포함되지 않습니다.
스토리
1 크레딧/v1/hackernews/storyid로 스토리 1건을 가져옵니다. 제목, 링크, 작성자, 점수, 댓글 수, 게시 시각이 포함됩니다. 토론은 story/comments에서 가져옵니다.
id
스토리 댓글
1 크레딧/v1/hackernews/story/comments스토리 하나의 댓글 트리를 반환합니다. id, 작성자, 본문, 점수, 작성 시각, 중첩 답글이 포함됩니다.
id
프로필
1 크레딧/v1/hackernews/profile공개 사용자 프로필을 반환합니다. id, 사용자명, 소개, 카르마, 계정 생성일이 포함됩니다. HN에 팔로워·게시글 수 개념이 없어 해당 값은 비어 있습니다.
handle
Hacker News API4개 엔드포인트 지원
문서 보기질의어와 맞는 Hacker News 글을 제목, 링크, 작성자, 점수, 댓글 수, 게시 시각과 함께 반환합니다. tags를 주면 댓글까지 범위가 넓어집니다.
키워드로 토론을 찾을 때 사용하세요. 여기서 얻은 story id를 story나 story/comments에 넘기면 상세와 댓글이 나옵니다.
GET/v1/hackernews/search?query=claude+code
query · Free-text search term.
$ curl https://www.socialcrawl.dev/v1/hackernews/search?query=claude+code \
-H "x-api-key: sc_YOUR_API_KEY"— · 대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Hacker News API 동작
Hacker News도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/hackernews/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. HN 계정과 별도 SDK는 없습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. Hacker News 자격 증명은 필요 없습니다. 카탈로그 전 구간에 같은 키를 사용합니다.
GET과 쿼리 파라미터
Hacker News 라우트는 모두 GET입니다. query, id, tags, page, 필터를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
Hacker News 읽기는 라이브 미스당 1 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 검색 페이지는 더 있을 때 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 검색으로 시작한 뒤 스토리를 열고 필요한 스레드만 댓글을 펼칩니다.
01검색
GET /v1/hackernews/search?query=…&tags=story점수와 댓글 수가 있는 스토리 PostList입니다.
스토리 id를 알기 전에 키워드로 토론을 찾습니다.
02스토리
GET /v1/hackernews/story?id=…story id 하나인 전체 Post입니다.
검색 제목만으로는 스토리 레코드가 부족할 때 사용합니다.
03댓글
GET /v1/hackernews/story/comments?id=…중첩 replies[]가 있는 CommentList입니다.
토론 자체가 작업일 때만 트리를 펼칩니다.
04프로필
GET /v1/hackernews/profile?handle=…Author 형태 사용자입니다. 카르마, 소개, 생성일이 포함됩니다.
작성자가 중요해지면 한 번 확인합니다.
요청
GET /v1/hackernews/search
?query=launch+api
&tags=story
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
# deepen a story
GET /v1/hackernews/story?id=8863
GET /v1/hackernews/story/comments?id=8863응답 봉투
{
"success": true,
"data": {
"items": [
{
"post": {
"id": "8863",
"url": "https://news.ycombinator.com/item?id=8863",
"content": { "text": "Example title" },
"engagement": { "likes": 1200, "comments": 318 },
"ext": {
"points": 1200,
"author": "pg"
}
}
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다. 스토리와 댓글은 다른 플랫폼과 같은 리프를 사용합니다.
Authorprofile
id, username, bio, url, ext(karma, created_at). HN에서 followers와 게시글 수는 비어 있음
PostList / Postsearch, story
items[].post: id, url, content.text(제목), engagement(점수, 댓글), author, published_at, ext
CommentListstory/comments
items[]: author, content.text, engagement, published_at, replies[]. 중첩 토론
Search hitsenvelope fields
목록 형태의 Algolia 스타일 히트: objectID, title, url, author, points, num_comments, tags
게이트웨이
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Hacker News 전용 사이드카가 아닙니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.
- 02
검증 후 차감
레지스트리에서 hackernews/search 등을 찾습니다. 필수 파라미터 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 1 크레딧을 원자적으로 차감합니다.
- 03
캐시 또는 조회
platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 Hacker News fetcher가 HN Algolia 공개 API를 호출합니다. 5xx와 네트워크 오류는 재시도하며 불건전 시 서킷 브레이커가 동작합니다.
- 04
정규화 후 반환
업스트림 JSON을 필드 맵이 있는 경우 Author, Post, PostList, CommentList로 매핑합니다. Zod로 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.
과금 규칙
- 표준 라이브 미스는 1 크레딧입니다.
- search, story, comments, profile은 모두 1 크레딧입니다.
- 이 플랫폼에는 advanced 티어가 없습니다.
- 이 플랫폼에는 premium 티어가 없습니다.
- 캐시 히트는 0 크레딧입니다.
- 빈 응답과 하드 실패는 자동 환불됩니다.
- 잘못된 파라미터는 400이며 과금하지 않습니다.
- 잔액이 없으면 402이며 과금하지 않습니다.
- 비활성 라우트는 503이며 과금하지 않습니다.
데이터 수집
Hacker News는 공개 읽기 토론 데이터입니다. SocialCrawl 스키마로 정규화하므로 Algolia 전용 히트 형태를 코드에 넣을 필요가 없습니다.
API에서의 Hacker News
공개 스토리, 댓글, 사용자 프로필을 읽기 전용으로 제공합니다. 리서치, 모니터링, 제품 작업에 사용합니다. 투표와 제출은 없습니다.
업스트림
SocialCrawl 게이트웨이 뒤에서 공개 HN Algolia API(hn.algolia.com)를 호출합니다. 플랫폼 fetcher가 쿼리 파라미터와 id로 검색·아이템 URL을 구성합니다.
응답 형태
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 스토리는 Post로, 댓글은 중첩 replies가 있는 CommentList로 정규화됩니다.
미제공 항목
쓰기 엔드포인트는 없습니다. 비공개 메시지는 없습니다. 팔로워 그래프는 HN이 공개하지 않아 제공하지 않습니다. 활성 목록은 레지스트리 문서를 따릅니다.
필드 매핑
HN user→ author.*제목, url, 작성자, 점수, 댓글 수
story title + url + text→ post.content.text + ext.*댓글 본문, 작성자, 점수, 중첩 답글
nested comment tree→ CommentList + replies[]사용자명, 소개, 카르마, 계정 created_at
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
4active Hacker News endpoints in the registry
1 credit라이브 미스당 고정 1 크레딧
기술 토론 검색과 스레드 모니터링
호출은 키워드 검색, 스토리 상세, 스토리에서 댓글로 이어지는 체인에 집중됩니다. 작성자 맥락이 필요하면 프로필이 사용됩니다. 공유 스키마의 HN 검색, 스토리, 중첩 댓글, 프로필과 크레딧 과금입니다. HN 계정과 별도 클라이언트 라이브러리는 필요 없습니다.
검색과 스토리 호출은 라이브 미스 시 보통 수 초입니다. 큰 댓글 트리는 단일 스토리 읽기보다 더 걸릴 수 있습니다.
Hacker News API 활용 사례
Hacker News 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
기술 모니터
Python, cron, Slack 봇고정 키워드로 검색을 폴링합니다. 점수나 댓글 속도가 급증하면 story와 comments를 엽니다.
리서치 노트북
Node, 노트북, BI 적재HN 키워드 검색 후 스토리와 댓글 트리를 펼쳐 제품, 브랜드, 경쟁 언어를 확인합니다.
백엔드 제품 잡
Go, 워커, Explorer검색, 스토리, 댓글을 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다. 카탈로그와 같은 API 키를 사용합니다.
호출 예시
Hacker News 라우트는 라이브 호출당 1 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/hackernews/search?query=launch+api&tags=story" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/hackernews/story/comments?id=8863" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Hacker News API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 공식 HN Firebase API + Algolia, 뭐가 다른가요?
같은 Hacker News 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 공식 HN Firebase API + Algolia |
|---|---|---|
| 인증 | 48개 플랫폼을 아우르는 x-api-key 하나면 돼요 | 키는 필요 없지만 서로 다른 API 두 개를 익혀야 해요 |
| 시작하기 | 다른 소스와 같은 응답 구조로 GET 요청 하나면 끝이에요 | 아이템은 Firebase, 검색은 Algolia. 클라이언트도 응답 형태도 두 벌이에요 |
| 레이트리밋 | 서비스가 업스트림에서 알아서 처리해 드려요 | 넉넉하지만 명시돼 있지 않아서 백오프를 직접 만들어야 해요 |
| 응답 스키마 | Reddit·GitHub·X와 같은 통합 data.items 구조예요 | Firebase는 아이템을 ID 하나씩, Algolia는 자체 hit 형식으로 돌려줘요 |
| 요금 | 호출당 1 크레딧, 신용카드 없이 100 크레딧 무료 | 무료 |
| 데이터 범위 | 검색·스토리·전체 댓글 트리·프로필을 네 번의 호출로 받아요 | 아이템 자체는 다 있지만 댓글 트리는 댓글 ID마다 요청 한 번씩이에요 |
인증
SocialCrawl
48개 플랫폼을 아우르는 x-api-key 하나면 돼요
공식 HN Firebase API + Algolia
키는 필요 없지만 서로 다른 API 두 개를 익혀야 해요
시작하기
SocialCrawl
다른 소스와 같은 응답 구조로 GET 요청 하나면 끝이에요
공식 HN Firebase API + Algolia
아이템은 Firebase, 검색은 Algolia. 클라이언트도 응답 형태도 두 벌이에요
레이트리밋
SocialCrawl
서비스가 업스트림에서 알아서 처리해 드려요
공식 HN Firebase API + Algolia
넉넉하지만 명시돼 있지 않아서 백오프를 직접 만들어야 해요
응답 스키마
SocialCrawl
Reddit·GitHub·X와 같은 통합 data.items 구조예요
공식 HN Firebase API + Algolia
Firebase는 아이템을 ID 하나씩, Algolia는 자체 hit 형식으로 돌려줘요
요금
SocialCrawl
호출당 1 크레딧, 신용카드 없이 100 크레딧 무료
공식 HN Firebase API + Algolia
무료
데이터 범위
SocialCrawl
검색·스토리·전체 댓글 트리·프로필을 네 번의 호출로 받아요
공식 HN Firebase API + Algolia
아이템 자체는 다 있지만 댓글 트리는 댓글 ID마다 요청 한 번씩이에요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기SocialCrawl의 Hacker News API는 무엇인가요?
Algolia 기반 해커뉴스 검색 API를 검색, 스토리, 스토리 댓글, 프로필 엔드포인트 4종으로 감싸서 x-api-key 하나로 호출할 수 있게 해드려요. Reddit, GitHub, X 같은 다른 47개 소스와 똑같은 스키마로 받아볼 수 있어 별도 Algolia 연동이 필요 없어요.
어떤 Hacker News 엔드포인트를 지원하나요?
엔드포인트 4종을 쓰실 수 있어요: Search, Story, Story Comments, and Profile.
Hacker News API는 무료인가요? Algolia 키가 필요한가요?
해커뉴스 데이터는 원래 공개돼 있고 무료라서 SocialCrawl이 잠긴 데이터를 파는 건 아니에요. Algolia 계정이나 키도 필요 없어요. 가치는 키 하나와 통합 스키마로 48개 소스를 똑같이 다룬다는 점이라, HN도 다른 플랫폼과 같은 파이프라인에 그대로 들어가요.
Hacker News API는 요금이 얼마인가요?
모든 해커뉴스 엔드포인트는 1 크레딧(스탠다드 티어)이 들어요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받을 수 있어서, 엔드포인트 4종을 모두 테스트하고 작은 수집 작업까지 돌려본 뒤에 결제하실 수 있어요.
SocialCrawl Hacker News API는 왜 쓰나요?
기술 트렌드 모니터링, 개발자 반응 추적, Show HN·런칭 추적 파이프라인을 만드는 분께 딱이에요. 이미 Reddit·GitHub·X를 SocialCrawl로 가져오고 있다면, 키 하나와 스키마 하나로 HN까지 같은 파이프라인에 묶을 수 있어 훨씬 쉽고 간편해요.
각 응답에는 어떤 데이터가 들어있나요?
스토리는 제목, URL, 점수, 작성자, 댓글 수, 아이템 ID를 돌려줘요. 댓글은 본문, 작성자, 부모 댓글, 답글 트리를 담고, 프로필은 카르마, 가입일, 소개글을 담아요. 네 엔드포인트 모두 SocialCrawl의 data.items 스키마에 맞춰져 있어요.
가장 좋은 해커뉴스 스크레이퍼 API는 무엇인가요?
검색·스토리·댓글 트리·프로필까지 엔드포인트 4종을 호출당 1 크레딧으로 쓰는 SocialCrawl이 실용적인 선택이에요. 공식 Firebase API는 무료지만 아이템을 하나씩 가져와야 해서, 댓글 300개짜리 스레드면 요청도 300번이 필요해요. SocialCrawl은 트리 전체를 한 번에 돌려드리고, 신용카드 없이 100 크레딧으로 시작할 수 있어요.
Hacker News 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Hacker News 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Hacker News 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Hacker News 스크래핑 API와 공식 Hacker News API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Hacker News 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧 하나로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요 — SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요