질문 검색
1 크레딧/v1/stackoverflow/search검색어에 맞는 질문을 태그로 좁혀 관련도, 추천 수, 활동, 작성일 순으로 반환합니다. 각 질문의 번호, 제목, 링크, 일반 텍스트 본문, 태그, 점수, 조회수, 답변 수, 채택 여부가 포함됩니다. 페이지당 최대 100개, 25페이지까지 조회합니다. 표준 티어(1 크레딧)입니다.
query, tagged, sort, page, limit
SocialCrawl API 키로 Stack Overflow를 키워드와 태그로 검색하고 질문별 답변, 댓글, 점수, 채택된 답변을 구조화 JSON으로 가져옵니다. 호출은 크레딧으로 과금됩니다.
활성 엔드포인트는 4개입니다. 질문 검색, 질문 상세, 답변, 댓글을 지원합니다.
공개 Stack Overflow 질문을 읽는 엔드포인트는 4개입니다. 키워드와 태그로 검색한 뒤 질문 하나를 답변, 댓글과 함께 읽습니다.
/v1/stackoverflow/search검색어에 맞는 질문을 태그로 좁혀 관련도, 추천 수, 활동, 작성일 순으로 반환합니다. 각 질문의 번호, 제목, 링크, 일반 텍스트 본문, 태그, 점수, 조회수, 답변 수, 채택 여부가 포함됩니다. 페이지당 최대 100개, 25페이지까지 조회합니다. 표준 티어(1 크레딧)입니다.
query, tagged, sort, page, limit
/v1/stackoverflow/question번호나 링크로 질문 하나를 반환합니다. 제목, 일반 텍스트 전체 본문, 태그, 작성자, 점수, 조회수, 답변 수, 채택된 답변 id, 마지막 활동과 수정 시각, 콘텐츠 라이선스가 포함됩니다. Stack Overflow에 없는 번호는 404를 반환하며 과금되지 않습니다. 표준 티어(1 크레딧)입니다.
id or url
/v1/stackoverflow/question/answers질문의 답변을 추천 순, 활동 순, 작성일 순으로 반환하며, 각 답변의 전체 내용, 작성자, 점수, 채택 여부가 포함됩니다. 표준 티어(1 크레딧)입니다.
id or url, sort, page, limit
/v1/stackoverflow/question/comments질문에 달린 댓글을 최신순으로 반환하며, 각 댓글의 내용, 작성자, 점수, 수정 여부가 포함됩니다. 표준 티어(1 크레딧)입니다.
id or url, page, limit
검색어와 태그로 Stack Overflow 질문을 찾아 각 질문의 제목, 본문, 태그, 점수, 조회수, 답변 수를 반환합니다.
라이브러리나 오류, 주제에 대해 개발자들이 묻는 질문을 찾은 뒤 질문 하나를 자세히 읽을 때 사용하세요.
1크레딧
query · Search terms, 1 to 300 characters, for example pandas groupby.
$ curl https://www.socialcrawl.dev/v1/stackoverflow/search?query=pandas+groupby&tagged=python \
-H "x-api-key: sc_YOUR_API_KEY"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Stack Overflow도 SocialCrawl의 일반 데이터 표면입니다. API 키로 GET /v1/stackoverflow/…를 호출하고, 실시간 조회에만 크레딧을 쓰며, 하나의 JSON 응답 형식을 받습니다.
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Stack Overflow 계정이나 앱 등록은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
검색은 query, tagged, sort를 받습니다. 질문, 답변, 댓글은 id나 url을 받습니다. 목록은 page와 limit을 받습니다. 과금 전에 형식을 검증합니다.
모든 Stack Overflow 경로는 1 크레딧입니다. 캐시 적중은 0 크레딧입니다.
모든 응답은 success, data, credits_used, credits_remaining, request_id, cached로 같은 형태입니다. 페이지가 있는 경로의 목록에는 pagination이 함께 담깁니다.
대부분 제품은 주제를 한 번 검색한 뒤 관심 있는 질문을 답변과 함께 읽습니다.
GET /v1/stackoverflow/search?query=…&tagged=…번호, 점수, 태그가 담긴 질문 PostList
질문 번호는 모든 링크에 들어 있어 이미 아는 질문은 검색이 필요 없습니다.
GET /v1/stackoverflow/question?id=…전체 본문과 채택된 답변 id가 담긴 Post
한 번의 호출로 질문과 해결 여부를 확인합니다.
GET /v1/stackoverflow/question/answers?id=…점수와 is_accepted가 담긴 답변 CommentList
채택된 답변이나 가장 많이 추천된 해법을 고릅니다.
GET /v1/stackoverflow/search?query=pandas+groupby&tagged=python&sort=votes
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/stackoverflow/question/answers?id=11227809{
"success": true,
"data": {
"post": {
"id": "11227809",
"content": { "text": "Why is conditional processing of a sorted array faster than of an unsorted array?" },
"engagement": { "likes": 27549, "views": 2038548, "comments": 25 },
"ext": {
"tags": ["java", "c++", "performance", "cpu-architecture", "branch-prediction"],
"stackoverflow": {
"is_answered": true,
"accepted_answer_id": "11227902"
}
}
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}아키타입이 같으면 필드 이름도 SocialCrawl 전체와 같습니다. 한 번 파싱해 모든 플랫폼에 재사용합니다.
items[]에 post.id(질문 번호), content.text(제목), url, ext.description(본문), ext.tags, engagement likes, views, comments
같은 질문의 전체 내용과 ext.stackoverflow is_answered, accepted_answer_id, last_activity_at
답변이나 댓글의 id, url, text, author, engagement.likes, 답변의 ext.stackoverflow.is_accepted
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기를 따릅니다. Stack Overflow는 별도 부가 기능이 아닙니다.
Next.js catch-all 경로가 Hono social API로 전달합니다. request_id를 발급하고 키를 인증한 뒤 속도 제한(분당 600회)과 동시성(키당 50건)을 적용합니다.
레지스트리에서 stackoverflow 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 실행합니다. 잘못된 입력은 과금 없이 400을 반환합니다. 유효한 호출은 조회 전에 티어 비용을 원자적으로 차감합니다.
platform, resource, params로 결정적 캐시 키를 만듭니다. 적중하면 즉시 반환하고 credits_used는 0입니다. 미스이면 공개 데이터를 실시간으로 읽으며, 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커가 작동합니다.
Stack Overflow 데이터를 Post, PostList, CommentList 아키타입으로 매핑하고 Stack Overflow 고유 정보는 ext.stackoverflow에 담아 검증한 뒤, 성공 응답으로 감싸 과금 감사용으로 기록합니다.
운영에서 중요한 과금 규칙
Stack Overflow 질문과 답변은 공개 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 공급사 SDK를 익힐 필요가 없습니다.
stackoverflow.com의 공개 질문, 답변, 댓글과 각 항목의 점수, 태그, 채택된 답변입니다.
공개 데이터를 요청 시 읽어 서버에서 정규화합니다. Stack Exchange 앱을 등록할 필요가 없으며 사이트 자체의 요청 할당량은 SocialCrawl이 처리합니다.
질문은 PostList와 Post, 답변과 댓글은 CommentList로 공통 형태입니다. Stack Overflow 고유 정보는 ext.stackoverflow에 담깁니다.
투표, 게시, 비공개 팀, 사용자 받은편지함, 계정 데이터는 제공하지 않습니다.
이 API가 가장 많이 쓰이는 작업입니다.
개발자 질문 조사, 문서 공백 파악, 지원 모니터링
호출하는 쪽은 라이브러리나 오류 메시지를 검색한 뒤 중요한 질문과 답변을 주기적으로 읽습니다. 질문, 채택된 답변, 점수, 태그를 일반 텍스트로 공통 Post와 Comment 스키마에 담아 하나의 키로 제공합니다. Stack Exchange 앱을 등록할 필요가 없습니다.
캐시 미스는 공개 사이트를 요청 시 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 처리됩니다.
팀이 이 데이터를 활용하는 대표적인 방식과 주로 쓰는 기술 스택입니다.
라이브러리 태그로 search를 호출해 새 질문을 찾고, answers로 아직 해결되지 않은 질문을 확인합니다.
추천 순으로 search를 호출해 제품에 대해 가장 많이 묻는 질문을 찾고, 전체 내용을 읽어 문서 계획을 세웁니다.
작성일 순으로 search를 주기적으로 호출해 오류 메시지가 나타나기 시작한 날 바로 파악합니다.
모든 Stack Overflow 경로는 1 크레딧입니다. 캐시 적중은 무료입니다.
curl "https://www.socialcrawl.dev/v1/stackoverflow/search?query=pandas%20groupby&tagged=python" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/stackoverflow/question/answers?id=11227809" \
-H "x-api-key: sc_your_api_key_here"모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요