Healthy Available Limited Mostly unavailable No data
Healthy
Loading health status...
24h trend
30d trend
Retrieves comments for a Weibo post identified by MID, with optional maxId cursor pagination and time or hot sorting. Use it to review audience discussion, continue through comment pages, or support moderation and feedback analysis.
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE'
text
I want to use the "Post Comments (V1)" API from JustOneAPI.Base URL: https://api.justoneapi.com.API Path: /api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUEAPI Endpoint: BASE_URL + /api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUEHTTP Method: GETAuthentication: Append the "token" query parameter to the URL.OpenAPI Definition: https://docs.justoneapi.com/openapi/weibo/post-comments-v1-en.jsonParameters:- token (query): API access token. (Required)- mid (query): Weibo post mid. (Required)- sort (query): Sort order for the result set.Available Values:- `TIME`: Time- `HOT`: Hot- maxId (query): Pagination cursor returned by the previous response.Return format: safely handle JSON or text according to the actual Content-Type.Response Handling & Error Codes:1. Business results should be determined by the "code" field in the response body (code 0 means success).2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.3. Business Code Reference: - 0: Success - 100: Invalid or Inactive Token - 301: Collection Failed. Please Retry. - 302: Rate Limit Exceeded - 303: Daily Quota Exceeded - 400: Invalid Parameters - 500: Internal Server Error - 600: Permission Denied - 601: Insufficient Balance - 602: Token Budget Exceeded4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.Please help me write a script in my preferred programming language to call this API and handle the response.
python
import requestsBASE_URL = "https://api.justoneapi.com" # Provided by OpenAPI serversurl = BASE_URL + "/api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE"response = requests.get(url, timeout=120)print(response.status_code)if response.content: content_type = response.headers.get("content-type", "").lower() if "json" in content_type: try: print(response.json()) except ValueError: print(response.text) elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}: print(response.text) else: with open("response.bin", "wb") as output: output.write(response.content) print(f"Saved {len(response.content)} bytes to response.bin")
Weibo post comments for the requested page, with preview replies and pagination information.
Field
Type
Description
ok
integer
Status flag inside the Weibo comment payload.
total_number
integer
Total comment count reported for the post. The current page can contain fewer entries.
max_id
integer
Cursor for the next post comment page. Pass its exact decimal text as maxId for the same post and sort. Zero indicates no next cursor. This field can be absent in an empty response.
data
array
First-level comments for the requested page. This array can be empty.
data[]
object
One top-level comment on the requested Weibo post.
rootComment
array
Additional root-comment array reported with the response. The array was empty in verified samples.
tip_msg
string
Display hint for the comment list. The string can be empty.
trendsText
string
Trends-related display text reported with the comment list.
filter_group
array
Filter choices returned for the comment list.
filter_group[]
object
One filter choice shown for the comment list.
filter_group[].title
string
Display label of the filter choice.
filter_group[].isDefault
integer
Numeric flag for whether this is the default filter choice.
Top-level comment15 fields
data.data[]
Field
Type
Description
id
integer
Comment ID returned as an integer. Use idstr when preserving exact digits.
idstr
string
Exact comment ID as a string.
mid
string
Comment’s own MID as a string. The request parameter mid identifies the post.
rootid
integer
Root comment ID reported for the thread, returned as an integer.
rootidstr
string
Exact root comment ID as a string.
floor_number
integer
Comment position number reported within the thread.
created_at
string
Creation time of the comment as platform-formatted text.
text
string
Rendered comment content. This text can contain HTML.
text_raw
string
Raw comment text when supplied separately from the rendered content.
source
string
Source label displayed with the comment.
source_allowclick
integer
Numeric platform flag for whether the source label is clickable.
source_type
integer
Type code reported for the comment source label.
disable_reply
integer
Numeric platform flag indicating whether replies are disabled.
like_counts
integer
Like count reported in the like_counts field.
isLikedByMblogAuthor
boolean
Whether the Weibo post author liked the comment, when provided.
Top-level comment author45 fields
data.data[]
Field
Type
Description
user
object
Public profile information for the comment author.
user.id
integer
Numeric ID of the Weibo user.
user.idstr
string
Exact Weibo user ID as a string.
user.screen_name
string
Display name of the Weibo user.
user.profile_image_url
string
Link to the user’s profile image.
user.avatar_large
string
Link to the large profile image.
user.avatar_hd
string
Link to the high-resolution profile image.
user.cover_image_phone
string
Link to the profile cover image for mobile.
user.profile_url
string
Path or link to the public Weibo profile.
user.domain
string
Custom profile address segment, when available.
user.weihao
string
Weibo profile short number. The string can be empty.
user.url
string
Website link published on the user’s profile. The string can be empty.
user.description
string
Biography displayed on the user’s profile.
user.location
string
Location shown in the public profile.
user.gender
string
Gender code reported in the public profile.
user.verified
boolean
Whether the profile is marked as verified.
user.verified_type
integer
Verification type code reported for the profile.
user.verified_type_ext
integer
Additional verification type code, when available.
user.verified_reason
string
Verification description shown on the profile, when available.
user.followers_count
integer
Follower count reported for the profile.
user.followers_count_str
string
Follower count display text.
user.friends_count
integer
Number of accounts followed by the user.
user.statuses_count
integer
Post count reported for the profile.
user.status_total_counter
object
Status interaction counters reported for the profile.
user.status_total_counter.total_cnt_format
string | integer
Formatted interaction total, returned as text or an integer.
user.status_total_counter.comment_cnt
string
Comment count in the profile counters, returned as text.
user.status_total_counter.repost_cnt
string
Repost count in the profile counters, returned as text.
user.status_total_counter.like_cnt
string
Like count in the profile counters, returned as text.
user.status_total_counter.total_cnt
string
Total count reported in the profile counters, returned as text.
user.mbrank
integer
Weibo membership rank reported for the profile.
user.mbtype
integer
Platform membership type code for the profile.
user.svip
integer
Numeric SVIP flag reported for the profile.
user.vvip
integer
Numeric VVIP flag reported for the profile.
user.icon_list
array
Icons or badges shown for the profile.
user.icon_list[]
object
One profile badge or icon.
user.icon_list[].type
string
Type label reported for the profile icon.
user.icon_list[].data
object
Display and membership details for the profile icon.
user.icon_list[].data.mbrank
integer
Membership rank reported for the icon.
user.icon_list[].data.mbtype
integer
Platform membership type code reported for the icon.
user.icon_list[].data.svip
integer
Numeric SVIP flag in the icon metadata.
user.icon_list[].data.vvip
integer
Numeric VVIP flag in the icon metadata.
user.icon_list[].data.value
string
Text value reported for this profile icon.
user.icon_list[].data.icon_img
string
Image link for the profile icon.
user.icon_list[].data.title
string
Display title of the profile icon.
user.icon_list[].data.url
string
Link associated with the profile icon.
Topics, links and display33 fields
data.data[]
Field
Type
Description
url_objects
array
Additional URL entries attached to the comment. This array can be empty.
pic_num
integer
Number of pictures reported for the comment.
topic_struct
array
Topic labels and links attached to the comment.
topic_struct[]
object
One topic entry in the comment.
topic_struct[].title
string
Display title of the topic entry.
topic_struct[].topic_title
string
Title text reported for the topic.
topic_struct[].topic_url
string
Link associated with the topic.
url_struct
array
Structured links attached to the comment.
url_struct[]
object
One link entry in the comment.
url_struct[].url_title
string
Display title of the link.
url_struct[].url_type_pic
string
Image link for the icon associated with this link type.
url_struct[].ori_url
string
Original URL reported for the entry.
url_struct[].short_url
string
Short URL reported for the entry.
url_struct[].long_url
string
Long URL reported for the entry.
url_struct[].h5_target_url
string
Link to the web destination reported for the entry.
url_struct[].page_id
string
Page identifier associated with the link.
url_struct[].url_type
string
Link type code returned as a string.
url_struct[].object_type
string
Type label of the linked object.
comment_bubble
object
Display information for the comment bubble decoration.
comment_bubble.id
string
Identifier of the comment bubble decoration.
comment_bubble.name
string
Display name of the comment bubble decoration.
comment_bubble.start_color
string
Start color reported for the comment bubble.
comment_bubble.end_color
string
End color reported for the comment bubble.
comment_bubble.start_color_dark
string
Start color for the comment bubble in dark mode.
comment_bubble.end_color_dark
string
End color for the comment bubble in dark mode.
comment_bubble.icon_url
string
Image link for the bubble decoration icon.
comment_bubble.tag_text
string
Display label associated with the bubble decoration.
hot_icon
object
Display information for the comment’s hot badge.
hot_icon.url
string
Image link for the hot badge.
hot_icon.wh_ratio
string
Width-to-height ratio of the hot badge image, returned as text.
more_info
object
Additional display text attached to the comment.
more_info.text
string
Display text associated with the additional information.
more_info.highlight_text
string
Highlighted portion of the additional display text.
Reply previews and counts4 fields
data.data[]
Field
Type
Description
comments
array
Preview replies attached to this comment. Additional replies may exist beyond the preview.
comments[]
object
One reply preview attached to a first-level comment.
total_number
integer
Total reply count reported for this comment.
max_id
integer
Cursor reported with this comment’s reply preview. The post comment page cursor is the top-level max_id.
Preview reply24 fields
data.data[].comments[]
Field
Type
Description
id
integer
Comment ID returned as an integer. Use idstr when preserving exact digits.
idstr
string
Exact comment ID as a string.
mid
string
Comment’s own MID as a string. The request parameter mid identifies the post.
rootid
integer
Root comment ID reported for the thread, returned as an integer.
rootidstr
string
Exact root comment ID as a string.
floor_number
integer
Comment position number reported within the thread.
created_at
string
Creation time of the comment as platform-formatted text.
text
string
Rendered comment content. This text can contain HTML.
text_raw
string
Raw comment text when supplied separately from the rendered content.
source
string
Source label displayed with the comment.
source_allowclick
integer
Numeric platform flag for whether the source label is clickable.
source_type
integer
Type code reported for the comment source label.
disable_reply
integer
Numeric platform flag indicating whether replies are disabled.
like_counts
integer
Like count reported in the like_counts field.
url_objects
array
Additional URL entries attached to the comment. This array can be empty.
pic_num
integer
Number of pictures reported for the comment.
reply_comment
object
Embedded comment that the preview reply responds to.
like_count
integer
Like count reported in the like_count field of this reply.
is_mblog_author
boolean
Whether the reply author is the author of the Weibo post.
is_sub_cmt
boolean
Whether the platform marks this entry as a subcomment.
blogger_icons
array
Badges attached to the preview reply author.
blogger_icons[]
object
One displayed author badge.
blogger_icons[].name
string
Display name of the author badge.
blogger_icons[].url
string
Link associated with the author badge.
Preview reply author41 fields
data.data[].comments[]
Field
Type
Description
user
object
Public profile information for the preview reply author.
user.id
integer
Numeric ID of the Weibo user.
user.idstr
string
Exact Weibo user ID as a string.
user.screen_name
string
Display name of the Weibo user.
user.profile_image_url
string
Link to the user’s profile image.
user.avatar_large
string
Link to the large profile image.
user.avatar_hd
string
Link to the high-resolution profile image.
user.cover_image_phone
string
Link to the profile cover image for mobile.
user.profile_url
string
Path or link to the public Weibo profile.
user.domain
string
Custom profile address segment, when available.
user.weihao
string
Weibo profile short number. The string can be empty.
user.url
string
Website link published on the user’s profile. The string can be empty.
user.description
string
Biography displayed on the user’s profile.
user.location
string
Location shown in the public profile.
user.gender
string
Gender code reported in the public profile.
user.verified
boolean
Whether the profile is marked as verified.
user.verified_type
integer
Verification type code reported for the profile.
user.verified_type_ext
integer
Additional verification type code, when available.
user.verified_reason
string
Verification description shown on the profile, when available.
user.followers_count
integer
Follower count reported for the profile.
user.followers_count_str
string
Follower count display text.
user.friends_count
integer
Number of accounts followed by the user.
user.statuses_count
integer
Post count reported for the profile.
user.status_total_counter
object
Status interaction counters reported for the profile.
user.status_total_counter.total_cnt_format
string | integer
Formatted interaction total, returned as text or an integer.
user.status_total_counter.comment_cnt
string
Comment count in the profile counters, returned as text.
user.status_total_counter.repost_cnt
string
Repost count in the profile counters, returned as text.
user.status_total_counter.like_cnt
string
Like count in the profile counters, returned as text.
user.status_total_counter.total_cnt
string
Total count reported in the profile counters, returned as text.
user.mbrank
integer
Weibo membership rank reported for the profile.
user.mbtype
integer
Platform membership type code for the profile.
user.svip
integer
Numeric SVIP flag reported for the profile.
user.vvip
integer
Numeric VVIP flag reported for the profile.
user.icon_list
array
Icons or badges shown for the profile.
user.icon_list[]
object
One profile badge or icon.
user.icon_list[].type
string
Type label reported for the profile icon.
user.icon_list[].data
object
Display and membership details for the profile icon.
user.icon_list[].data.mbrank
integer
Membership rank reported for the icon.
user.icon_list[].data.mbtype
integer
Platform membership type code reported for the icon.
user.icon_list[].data.svip
integer
Numeric SVIP flag in the icon metadata.
user.icon_list[].data.vvip
integer
Numeric VVIP flag in the icon metadata.
Replied-to comment11 fields
data.data[].comments[].reply_comment
Field
Type
Description
id
integer
Comment ID returned as an integer. Use idstr when preserving exact digits.
idstr
string
Exact comment ID as a string.
mid
string
Comment’s own MID as a string. The request parameter mid identifies the post.
rootid
integer
Root comment ID reported for the thread, returned as an integer.
rootidstr
string
Exact root comment ID as a string.
floor_number
integer
Comment position number reported within the thread.
created_at
string
Creation time of the comment as platform-formatted text.
text
string
Rendered comment content. This text can contain HTML.
disable_reply
integer
Numeric platform flag indicating whether replies are disabled.
url_objects
array
Additional URL entries attached to the comment. This array can be empty.
pic_num
integer
Number of pictures reported for the comment.
Replied-to comment author45 fields
data.data[].comments[].reply_comment
Field
Type
Description
user
object
Public profile information for the author of the replied-to comment.
user.id
integer
Numeric ID of the Weibo user.
user.idstr
string
Exact Weibo user ID as a string.
user.screen_name
string
Display name of the Weibo user.
user.profile_image_url
string
Link to the user’s profile image.
user.avatar_large
string
Link to the large profile image.
user.avatar_hd
string
Link to the high-resolution profile image.
user.cover_image_phone
string
Link to the profile cover image for mobile.
user.profile_url
string
Path or link to the public Weibo profile.
user.domain
string
Custom profile address segment, when available.
user.weihao
string
Weibo profile short number. The string can be empty.
user.url
string
Website link published on the user’s profile. The string can be empty.
user.description
string
Biography displayed on the user’s profile.
user.location
string
Location shown in the public profile.
user.gender
string
Gender code reported in the public profile.
user.verified
boolean
Whether the profile is marked as verified.
user.verified_type
integer
Verification type code reported for the profile.
user.verified_type_ext
integer
Additional verification type code, when available.
user.verified_reason
string
Verification description shown on the profile, when available.
user.followers_count
integer
Follower count reported for the profile.
user.followers_count_str
string
Follower count display text.
user.friends_count
integer
Number of accounts followed by the user.
user.statuses_count
integer
Post count reported for the profile.
user.status_total_counter
object
Status interaction counters reported for the profile.
user.status_total_counter.total_cnt_format
string | integer
Formatted interaction total, returned as text or an integer.
user.status_total_counter.comment_cnt
string
Comment count in the profile counters, returned as text.
user.status_total_counter.repost_cnt
string
Repost count in the profile counters, returned as text.
user.status_total_counter.like_cnt
string
Like count in the profile counters, returned as text.
user.status_total_counter.total_cnt
string
Total count reported in the profile counters, returned as text.
user.mbrank
integer
Weibo membership rank reported for the profile.
user.mbtype
integer
Platform membership type code for the profile.
user.svip
integer
Numeric SVIP flag reported for the profile.
user.vvip
integer
Numeric VVIP flag reported for the profile.
user.icon_list
array
Icons or badges shown for the profile.
user.icon_list[]
object
One profile badge or icon.
user.icon_list[].type
string
Type label reported for the profile icon.
user.icon_list[].data
object
Display and membership details for the profile icon.
user.icon_list[].data.mbrank
integer
Membership rank reported for the icon.
user.icon_list[].data.mbtype
integer
Platform membership type code reported for the icon.
Weibo Post Comments API (V1)
Retrieves comments for a Weibo post identified by MID, with optional maxId cursor pagination and time or hot sorting. Use it to review audience discussion, continue through comment pages, or support moderation and feedback analysis.
Parameters
tokenstringmidstringsortstringTIMEAvailable Values:
-
TIME: Time-
HOT: HotmaxIdstringCode Samples
Response Fields
Key fields in a successful response (
code = 0).Pagination and filters12 fields
dataWeibo post comments for the requested page, with preview replies and pagination information.
okintegertotal_numberintegermax_idintegerdataarraydata[]objectrootCommentarraytip_msgstringtrendsTextstringfilter_grouparrayfilter_group[]objectfilter_group[].titlestringfilter_group[].isDefaultintegerTop-level comment15 fields
data.data[]idintegeridstrstringmidstringrootidintegerrootidstrstringfloor_numberintegercreated_atstringtextstringtext_rawstringsourcestringsource_allowclickintegersource_typeintegerdisable_replyintegerlike_countsintegerisLikedByMblogAuthorbooleanTop-level comment author45 fields
data.data[]userobjectuser.idintegeruser.idstrstringuser.screen_namestringuser.profile_image_urlstringuser.avatar_largestringuser.avatar_hdstringuser.cover_image_phonestringuser.profile_urlstringuser.domainstringuser.weihaostringuser.urlstringuser.descriptionstringuser.locationstringuser.genderstringuser.verifiedbooleanuser.verified_typeintegeruser.verified_type_extintegeruser.verified_reasonstringuser.followers_countintegeruser.followers_count_strstringuser.friends_countintegeruser.statuses_countintegeruser.status_total_counterobjectuser.status_total_counter.total_cnt_formatstring | integeruser.status_total_counter.comment_cntstringuser.status_total_counter.repost_cntstringuser.status_total_counter.like_cntstringuser.status_total_counter.total_cntstringuser.mbrankintegeruser.mbtypeintegeruser.svipintegeruser.vvipintegeruser.icon_listarrayuser.icon_list[]objectuser.icon_list[].typestringuser.icon_list[].dataobjectuser.icon_list[].data.mbrankintegeruser.icon_list[].data.mbtypeintegeruser.icon_list[].data.svipintegeruser.icon_list[].data.vvipintegeruser.icon_list[].data.valuestringuser.icon_list[].data.icon_imgstringuser.icon_list[].data.titlestringuser.icon_list[].data.urlstringTopics, links and display33 fields
data.data[]url_objectsarraypic_numintegertopic_structarraytopic_struct[]objecttopic_struct[].titlestringtopic_struct[].topic_titlestringtopic_struct[].topic_urlstringurl_structarrayurl_struct[]objecturl_struct[].url_titlestringurl_struct[].url_type_picstringurl_struct[].ori_urlstringurl_struct[].short_urlstringurl_struct[].long_urlstringurl_struct[].h5_target_urlstringurl_struct[].page_idstringurl_struct[].url_typestringurl_struct[].object_typestringcomment_bubbleobjectcomment_bubble.idstringcomment_bubble.namestringcomment_bubble.start_colorstringcomment_bubble.end_colorstringcomment_bubble.start_color_darkstringcomment_bubble.end_color_darkstringcomment_bubble.icon_urlstringcomment_bubble.tag_textstringhot_iconobjecthot_icon.urlstringhot_icon.wh_ratiostringmore_infoobjectmore_info.textstringmore_info.highlight_textstringReply previews and counts4 fields
data.data[]commentsarraycomments[]objecttotal_numberintegermax_idintegerPreview reply24 fields
data.data[].comments[]idintegeridstrstringmidstringrootidintegerrootidstrstringfloor_numberintegercreated_atstringtextstringtext_rawstringsourcestringsource_allowclickintegersource_typeintegerdisable_replyintegerlike_countsintegerurl_objectsarraypic_numintegerreply_commentobjectlike_countintegeris_mblog_authorbooleanis_sub_cmtbooleanblogger_iconsarrayblogger_icons[]objectblogger_icons[].namestringblogger_icons[].urlstringPreview reply author41 fields
data.data[].comments[]userobjectuser.idintegeruser.idstrstringuser.screen_namestringuser.profile_image_urlstringuser.avatar_largestringuser.avatar_hdstringuser.cover_image_phonestringuser.profile_urlstringuser.domainstringuser.weihaostringuser.urlstringuser.descriptionstringuser.locationstringuser.genderstringuser.verifiedbooleanuser.verified_typeintegeruser.verified_type_extintegeruser.verified_reasonstringuser.followers_countintegeruser.followers_count_strstringuser.friends_countintegeruser.statuses_countintegeruser.status_total_counterobjectuser.status_total_counter.total_cnt_formatstring | integeruser.status_total_counter.comment_cntstringuser.status_total_counter.repost_cntstringuser.status_total_counter.like_cntstringuser.status_total_counter.total_cntstringuser.mbrankintegeruser.mbtypeintegeruser.svipintegeruser.vvipintegeruser.icon_listarrayuser.icon_list[]objectuser.icon_list[].typestringuser.icon_list[].dataobjectuser.icon_list[].data.mbrankintegeruser.icon_list[].data.mbtypeintegeruser.icon_list[].data.svipintegeruser.icon_list[].data.vvipintegerReplied-to comment11 fields
data.data[].comments[].reply_commentidintegeridstrstringmidstringrootidintegerrootidstrstringfloor_numberintegercreated_atstringtextstringdisable_replyintegerurl_objectsarraypic_numintegerReplied-to comment author45 fields
data.data[].comments[].reply_commentuserobjectuser.idintegeruser.idstrstringuser.screen_namestringuser.profile_image_urlstringuser.avatar_largestringuser.avatar_hdstringuser.cover_image_phonestringuser.profile_urlstringuser.domainstringuser.weihaostringuser.urlstringuser.descriptionstringuser.locationstringuser.genderstringuser.verifiedbooleanuser.verified_typeintegeruser.verified_type_extintegeruser.verified_reasonstringuser.followers_countintegeruser.followers_count_strstringuser.friends_countintegeruser.statuses_countintegeruser.status_total_counterobjectuser.status_total_counter.total_cnt_formatstring | integeruser.status_total_counter.comment_cntstringuser.status_total_counter.repost_cntstringuser.status_total_counter.like_cntstringuser.status_total_counter.total_cntstringuser.mbrankintegeruser.mbtypeintegeruser.svipintegeruser.vvipintegeruser.icon_listarrayuser.icon_list[]objectuser.icon_list[].typestringuser.icon_list[].dataobjectuser.icon_list[].data.mbrankintegeruser.icon_list[].data.mbtypeintegeruser.icon_list[].data.svipintegeruser.icon_list[].data.vvipintegeruser.icon_list[].data.valuestringuser.icon_list[].data.icon_imgstringuser.icon_list[].data.titlestringuser.icon_list[].data.urlstringResponse Example