계정 프로필
1 크레딧/v1/weibo/profile핸들, 숫자 id, 프로필 링크 중 하나로 계정 하나를 조회합니다. 표시 이름, 소개, 인증 여부와 사유, 정확한 팔로워 수와 팔로잉 수와 게시물 수, 위치, 성별, 생일, 계정 생성일이 포함됩니다. 표준 티어(1 크레딧)입니다.
handle, id, url
Weibo API
공개 Weibo 데이터 API
SocialCrawl API 키 하나로 Weibo의 공개 계정, 게시물, 댓글, 검색 결과, 핫 검색 목록을 구조화 JSON으로 가져옵니다. 다른 플랫폼과 같은 Author, Post, Comment 스키마를 사용합니다. 호출은 크레딧으로 과금됩니다.
/v1/weibo
활성 엔드포인트는 8개입니다. 계정, 게시물, 댓글, 검색, 트렌드를 지원합니다.
- GET /v1/weibo/profile
- GET /v1/weibo/profile/posts
- GET /v1/weibo/post
- GET /v1/weibo/post/comments
- GET /v1/weibo/comment/replies
- GET /v1/weibo/search
- GET /v1/weibo/search/users
- GET /v1/weibo/trending
Weibo 엔드포인트
공개 Weibo 데이터를 읽는 엔드포인트는 8개입니다. 계정 조회, 게시물 목록, 댓글과 답글, 게시물과 계정 검색, 핫 검색 목록을 지원합니다.
계정 게시물
5 크레딧/v1/weibo/profile/posts계정의 게시물을 최신순으로 페이지당 최대 50개 반환합니다. 게시물마다 정확한 리포스트 수와 댓글 수와 좋아요 수, 작성 지역(성 또는 국가), 토픽, 미디어가 포함됩니다. 커서로 최근 약 2,000개 게시물까지 넘겨 볼 수 있습니다. 긴 게시물은 이 목록에서 줄여서 반환합니다. 고급 티어(5 크레딧)입니다.
handle, id, url, media_only, limit, cursor
게시물 상세
1 크레딧/v1/weibo/post게시물 하나를 전체 내용으로 반환합니다. 전체 본문, 작성자, 시간, 작성 지역, 정확한 리포스트 수와 댓글 수와 좋아요 수와 조회 수, 토픽, 모든 사진과 영상이 포함됩니다. 표준 티어(1 크레딧)입니다.
url
게시물 댓글
5 크레딧/v1/weibo/post/comments게시물의 댓글을 좋아요순(hot) 또는 최신순(latest)으로 반환합니다. 댓글마다 본문, 시간, 작성 지역, 좋아요 수, 답글 수, 정확한 팔로워 수가 있는 작성자가 포함됩니다. 아주 큰 스레드는 Weibo가 수백 개에서 끊습니다. 고급 티어(5 크레딧)입니다.
url, sort, limit, cursor
댓글 답글
5 크레딧/v1/weibo/comment/replies댓글 하나 아래의 답글을 오래된 순으로 반환합니다. 답글마다 어떤 댓글에 대한 것인지 comment.parent_id에 담기고 작성 지역, 좋아요 수, 작성자가 포함됩니다. comment_id는 게시물 댓글 경로에서 가져옵니다. 고급 티어(5 크레딧)입니다.
comment_id, limit, cursor
게시물 검색
5 크레딧/v1/weibo/search키워드 또는 #토픽#에 맞는 공개 게시물을 최신순으로 페이지당 최대 50개 반환합니다. since와 until로 특정 기간을 몇 년 전까지 읽을 수 있습니다. 탭은 latest, all, original, verified, top, hot, videos, media, images를 지원합니다. Weibo 자체 검색이 보여 주는 게시물이므로 전수 조사는 아닙니다. 고급 티어(5 크레딧)입니다.
query, tab, since, until, limit, cursor
계정 검색
5 크레딧/v1/weibo/search/users이름 또는 키워드에 맞는 계정을 최대 50개 반환합니다. 표시 이름, 소개, 인증 여부와 사유, 게시물 수, 성별이 포함됩니다. 검색에서는 팔로워 수가 반올림되므로 author.followers는 null이며 정확한 값은 프로필 경로가 반환합니다. 고급 티어(5 크레딧)입니다.
query, limit
실시간 핫 검색
5 크레딧/v1/weibo/trendingWeibo의 실시간 핫 검색 목록을 반환합니다. 토픽마다 순위, 제목, 정확한 열기 점수, 카테고리, 신규 또는 핫 배지, 목록 진입 시간이 포함됩니다. 유료 노출은 include_promoted가 true일 때만 포함됩니다. 고급 티어(5 크레딧)입니다.
include_promoted, limit
Weibo API8개 엔드포인트 지원
문서 보기Profiles
Posts
Comments
Search
Trending
웨이보 계정 한 개의 이름, 소개글, 인증 여부와 사유, 정확한 팔로워 수, 팔로잉 수, 게시물 수, 지역, 성별, 생일, 가입일을 반환합니다.
게시물을 가져오기 전에 계정 규모를 파악하거나, 계정 검색에서 빠지는 정확한 팔로워 수가 필요할 때 사용하세요.
1크레딧
GET/v1/weibo/profile?id=2803301701
$ curl https://www.socialcrawl.dev/v1/weibo/profile?id=2803301701 \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Weibo API 동작
Weibo도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/weibo/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Weibo 계정이나 개발자 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
GET과 쿼리 파라미터
경로에 따라 handle, id, url, query, comment_id를 쿼리로 전달합니다. 계정 경로는 handle, id, url 중 하나를 받습니다. 과금 전에 형식을 검증합니다.
크레딧 과금
계정 프로필과 게시물 상세는 1 크레딧입니다. 나머지 Weibo 경로는 5 크레딧입니다. 캐시 히트는 0입니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 대상을 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
01계정 찾기
GET /v1/weibo/search/users?query=…검색에 맞는 계정 AuthorList
검색은 표시 이름과 id를 반환하며 팔로워 수는 반올림됩니다.
02계정 읽기
GET /v1/weibo/profile?id=…정확한 팔로워, 팔로잉, 게시물 수가 있는 Author
검색이 반올림한 수치를 프로필 경로가 정확하게 반환합니다.
03게시물 목록
GET /v1/weibo/profile/posts?id=…최신순 PostList, 페이지당 최대 50개
커서로 최근 약 2,000개 게시물까지 넘겨 볼 수 있습니다.
04댓글 읽기
GET /v1/weibo/post/comments?url=…hot 또는 latest 정렬 CommentList
독자 반응을 확인할 수 있으며 답글은 호출 한 번이면 이어집니다.
요청
GET /v1/weibo/profile?id=2803301701
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/weibo/profile/posts?id=2803301701&limit=50응답 봉투
{
"success": true,
"data": {
"author": {
"id": "2803301701",
"username": "rmrb",
"display_name": "Example account",
"followers": 1000000,
"joined_at": "2010-01-01T00:00:00Z"
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 여러 플랫폼에 재사용합니다.
Authorprofile
표시 이름, username, 소개, verified, followers, following, posts_count, location, joined_at
PostListprofile/posts
items[]에 본문, 리포스트 수와 댓글 수와 좋아요 수, ext.ip_location, 미디어, 커서
CommentListpost/comments
items[]에 본문, 좋아요 수, 답글 수, ext.ip_location, 답글의 parent_id
SearchResulttrending
순위, 제목, 열기 점수, 카테고리, 배지가 있는 핫 검색 토픽
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Weibo은 사이드카가 아닙니다.
- 01
엣지가 호출을 받음
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
- 02
검증 후 차감
레지스트리에서 weibo 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 읽기를 시작하기 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 페이지를 실시간으로 읽으며 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커를 사용합니다.
- 04
정규화 후 반환
Weibo JSON을 Author, PostList, Post, CommentList 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- profile, post: 1 크레딧
- 나머지 Weibo 경로: 5 크레딧
- 캐시 히트: 0 크레딧
- 빈 응답 / 하드 실패: 자동 환불
- 잘못된 파라미터: 400, 과금 없음
- 크레딧 부족: 402, 과금 없음
- 게시물은 페이지당 최대 50개
- 검색은 Weibo 전수 조사가 아님
- 쓰기·게시 도구 없음
Weibo 데이터 수집 방식
Weibo는 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
이 API에서 Weibo의 의미
weibo.com의 공개 계정, 게시물, 댓글, 검색 결과, 핫 검색 목록입니다.
SocialCrawl 수집 경로
공개 페이지를 요청 시점에 읽어 서버에서 정규화합니다. Weibo 로그인이나 세션을 직접 운영할 필요가 없습니다.
엣지에서 나가는 형태
Author, PostList, Post, CommentList, AuthorList, SearchResult입니다.
라이브로 제공하지 않는 것
게시, 메시지, 팔로우, 비공개 콘텐츠는 제공하지 않습니다.
필드 매핑
Weibo account→ author.*handle, id, url 지원, 프로필은 정확한 수치
posts and comments→ PostList / CommentList게시물과 댓글에 ext.ip_location 포함
hot-search topic→ SearchResult열기 점수가 있는 순위 토픽
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
8active Weibo endpoints in the registry
1 / 5profile과 search의 크레딧 구간
중국어권 소셜 리스닝과 트렌드 추적
호출은 토픽이나 계정 검색에서 시작해 중요한 대상의 게시물, 댓글, 답글로 깊어집니다. 게시물, 댓글, 핫 검색 목록을 작성 지역과 함께 다른 플랫폼과 같은 스키마로 제공하며 Weibo 로그인을 관리할 필요가 없습니다.
라이브 미스는 요청 시점에 공개 페이지를 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 응답합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
브랜드·PR 팀
Python, Slack기간을 지정해 #토픽#을 검색하고 확산된 게시물의 댓글을 읽습니다.
시장 조사
Node, notebooks핫 검색 스냅샷과 키워드 검색으로 중국에서 화제가 되는 주제를 추적합니다.
인플루언서 분석
BI loadsprofile로 정확한 수치를, profile/posts로 최근 반응을 확인합니다.
두 줄로 호출
프로필은 1 크레딧입니다. 게시물은 5 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/weibo/profile?id=2803301701" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/weibo/profile/posts?id=2803301701&limit=50" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Weibo API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기SocialCrawl 웨이보 API는 무엇을 제공하나요?
엔드포인트 8종(Profile, Profile Posts, Post, Post Comments, Comment Replies, Search, Search Users, and Trending)으로 계정 프로필, 계정의 게시물, 게시물 상세, 댓글과 답글, 게시물과 계정 검색, 실시간 인기 검색어를 받아요. 다른 74개 플랫폼과 같은 통합 JSON으로 와요.
예전 웨이보 게시물도 검색할 수 있나요?
네, GET /v1/weibo/search에 since와 until을 넣으면 정해 둔 기간의 게시물을 읽어요. 확인된 범위는 2015년까지예요. 웨이보 자체 검색이 보여 주는 게시물이라 전수 조사는 아니에요.
웨이보 계정이나 토큰이 필요한가요?
아니요. SocialCrawl API 키 하나로 호출하니 웨이보 로그인이나 신청, 토큰 관리가 필요 없어요.
웨이보 인기 검색어는 무엇인가요?
웨이보가 실시간으로 보여 주는 트렌드 주제 순위표(热搜)예요. GET /v1/weibo/trending이 주제별 순위, 제목, 정확한 열기 점수, 카테고리, 배지, 진입 시각을 줘요.
웨이보 API는 크레딧이 얼마나 드나요?
프로필, 게시물 같은 단건 조회는 1 credit, 목록과 검색, 댓글은 5 credits예요. 새 계정은 카드 없이 무료 100 크레딧을 받아요.
Weibo 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Weibo 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Weibo 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Weibo 스크래핑 API와 공식 Weibo API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Weibo 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요