Skip to content

微博帖子评论 API (V1) ​

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

检索由MID标识的微博帖子的评论,支持可选的maxId游标分页以及时间或热度排序。用于查看受众讨论、继续翻阅评论区或支持审核和反馈分析。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-API 访问令牌。
midquerystring是-微博帖子 mid。
sortquerystring否TIME结果集的排序顺序。


可用值:

- TIME: 时间

- HOT: 热门
maxIdquerystring否-由先前响应返回的分页游标。

代码示例 ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE'
text
我想使用 JustOneAPI 提供的“帖子评论 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE
接口地址: BASE_URL + /api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/weibo/post-comments-v1-zh.json

请求参数说明:
- token (query): API 访问令牌。 (必填)
- mid (query): 微博帖子 mid。 (必填)
- sort (query): 结果集的排序顺序。

可用值:
- `TIME`: 时间
- `HOT`: 热门
- maxId (query): 由先前响应返回的分页游标。

返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。

响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败,请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 账户余额不足
   - 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。

请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。
python
import requests

BASE_URL = "https://api.justoneapi.com"  # 由 OpenAPI servers 提供

url = 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")
js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
        final String url = BASE_URL + "/api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
go
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/weibo/get-post-comments/v1?token=YOUR_API_KEY&mid=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}

返回字段 ​

业务成功时(code = 0)的主要返回字段。

分页与筛选12 个字段

data

请求页的微博评论、预览回复和分页信息。

字段类型说明
okinteger微博评论数据对象内部的状态标记。
total_numberinteger博文返回的评论总数。当前页的评论条数可以少于这个值。
max_idinteger博文评论续页游标。同一博文和排序方式下,把完整的十进制文本传给 maxId。0 表示没有下一页游标。空结果可能省略该字段。
dataarray请求页的一级评论,数组可能为空。
data[]object请求的微博博文下的一条一级评论。
rootCommentarray响应附带的根评论数组。已核对的样本中该数组为空。
tip_msgstring评论列表的展示提示,可能为空字符串。
trendsTextstring评论列表返回的趋势相关展示文本。
filter_grouparray评论列表返回的筛选选项。
filter_group[]object评论列表的一项筛选选项。
filter_group[].titlestring筛选选项的展示标题。
filter_group[].isDefaultinteger该筛选项是否为默认项的数字标记。
一级评论15 个字段

data.data[]

字段类型说明
idinteger评论 ID,以整数返回。需要保留完整数字时可用 idstr。
idstrstring评论 ID 的字符串形式。
midstring评论自身的 MID,以字符串返回。请求参数 mid 标识的是博文。
rootidinteger该评论线程的根评论 ID,以整数返回。
rootidstrstring根评论 ID 的字符串形式。
floor_numberinteger线程内返回的评论楼层号。
created_atstring评论发布时间,以平台格式的文本返回。
textstring用于展示的评论内容,可能包含 HTML。
text_rawstring与展示内容分开返回的原始评论文本。
sourcestring评论展示的来源标签。
source_allowclickinteger来源标签能否点击的平台数字标记。
source_typeinteger评论来源标签的类型代码。
disable_replyinteger平台标记评论是否关闭回复的数字值。
like_countsintegerlike_counts 字段返回的点赞数量。
isLikedByMblogAuthorboolean博文作者是否点赞该评论,有数据时返回。
一级评论作者45 个字段

data.data[]

字段类型说明
userobject评论作者的公开主页信息。
user.idinteger微博用户的数字 ID。
user.idstrstring微博用户 ID 的字符串形式。
user.screen_namestring微博用户的展示昵称。
user.profile_image_urlstring用户头像图片链接。
user.avatar_largestring大尺寸头像链接。
user.avatar_hdstring高清头像链接。
user.cover_image_phonestring移动端用户主页的封面图片链接。
user.profile_urlstring微博公开用户主页的路径或链接。
user.domainstring用户主页的自定义地址片段,有数据时提供。
user.weihaostring微博主页微号,可能为空字符串。
user.urlstring用户公开主页上填写的网站链接,可能为空字符串。
user.descriptionstring用户主页展示的简介。
user.locationstring公开用户主页展示的地区。
user.genderstring公开用户主页返回的性别代码。
user.verifiedboolean该用户资料是否带有认证标记。
user.verified_typeinteger用户主页返回的认证类型代码。
user.verified_type_extinteger额外的认证类型代码,有数据时返回。
user.verified_reasonstring用户主页展示的认证说明,有数据时返回。
user.followers_countinteger用户主页返回的粉丝数。
user.followers_count_strstring粉丝数量的展示文本。
user.friends_countinteger该用户关注的账号数量。
user.statuses_countinteger用户主页返回的发博数量。
user.status_total_counterobject用户主页返回的博文互动计数。
user.status_total_counter.total_cnt_formatstring | integer格式化的互动总数,以文本或整数返回。
user.status_total_counter.comment_cntstring主页计数中的评论数,以文本返回。
user.status_total_counter.repost_cntstring主页计数中的转发数,以文本返回。
user.status_total_counter.like_cntstring主页计数中的点赞数,以文本返回。
user.status_total_counter.total_cntstring主页计数中的总数,以文本返回。
user.mbrankinteger用户主页返回的微博会员等级。
user.mbtypeinteger用户主页的平台会员类型代码。
user.svipinteger用户主页返回的 SVIP 数字标记。
user.vvipinteger用户主页返回的 VVIP 数字标记。
user.icon_listarray用户主页展示的图标或标记。
user.icon_list[]object一项用户主页标记或图标。
user.icon_list[].typestring主页图标返回的类型标签。
user.icon_list[].dataobject主页图标的展示和会员信息。
user.icon_list[].data.mbrankinteger图标对应的会员等级。
user.icon_list[].data.mbtypeinteger图标对应的平台会员类型代码。
user.icon_list[].data.svipinteger图标信息中的 SVIP 数字标记。
user.icon_list[].data.vvipinteger图标信息中的 VVIP 数字标记。
user.icon_list[].data.valuestring该主页图标返回的文本值。
user.icon_list[].data.icon_imgstring主页图标的图片链接。
user.icon_list[].data.titlestring主页图标的展示标题。
user.icon_list[].data.urlstring主页图标关联的链接。
话题、链接与展示33 个字段

data.data[]

字段类型说明
url_objectsarray评论附带的额外链接条目,数组可能为空。
pic_numinteger评论返回的图片数量。
topic_structarray评论附带的话题标签和链接。
topic_struct[]object评论中的一条话题。
topic_struct[].titlestring话题条目的展示标题。
topic_struct[].topic_titlestring话题返回的标题文本。
topic_struct[].topic_urlstring话题关联的链接。
url_structarray评论附带的结构化链接信息。
url_struct[]object评论中的一条链接。
url_struct[].url_titlestring链接的展示标题。
url_struct[].url_type_picstring该链接类型对应的图标图片链接。
url_struct[].ori_urlstring该条目返回的原始链接。
url_struct[].short_urlstring该条目返回的短链接。
url_struct[].long_urlstring该条目返回的长链接。
url_struct[].h5_target_urlstring该条目返回的网页目标链接。
url_struct[].page_idstring链接关联的页面标识。
url_struct[].url_typestring链接类型代码,以字符串返回。
url_struct[].object_typestring链接所指对象的类型标签。
comment_bubbleobject评论气泡的装饰展示信息。
comment_bubble.idstring评论气泡装饰标识。
comment_bubble.namestring评论气泡装饰的展示名称。
comment_bubble.start_colorstring评论气泡返回的起始颜色。
comment_bubble.end_colorstring评论气泡返回的结束颜色。
comment_bubble.start_color_darkstring深色模式下评论气泡的起始颜色。
comment_bubble.end_color_darkstring深色模式下评论气泡的结束颜色。
comment_bubble.icon_urlstring气泡装饰图标的图片链接。
comment_bubble.tag_textstring气泡装饰对应的展示标签。
hot_iconobject评论热度标记的展示信息。
hot_icon.urlstring热度标记的图片链接。
hot_icon.wh_ratiostring热度标记图片的宽高比,以文本返回。
more_infoobject评论附带的更多信息展示文本。
more_info.textstring更多信息的展示文本。
more_info.highlight_textstring更多信息展示文本的高亮部分。
预览回复与计数4 个字段

data.data[]

字段类型说明
commentsarray该评论附带的预览回复。还可能有未包含在预览中的回复。
comments[]object一级评论附带的一条预览回复。
total_numberinteger该评论返回的回复总数。
max_idinteger该评论预览回复附带的游标。博文评论列表使用响应对象最外层的 max_id。
预览回复内容24 个字段

data.data[].comments[]

字段类型说明
idinteger评论 ID,以整数返回。需要保留完整数字时可用 idstr。
idstrstring评论 ID 的字符串形式。
midstring评论自身的 MID,以字符串返回。请求参数 mid 标识的是博文。
rootidinteger该评论线程的根评论 ID,以整数返回。
rootidstrstring根评论 ID 的字符串形式。
floor_numberinteger线程内返回的评论楼层号。
created_atstring评论发布时间,以平台格式的文本返回。
textstring用于展示的评论内容,可能包含 HTML。
text_rawstring与展示内容分开返回的原始评论文本。
sourcestring评论展示的来源标签。
source_allowclickinteger来源标签能否点击的平台数字标记。
source_typeinteger评论来源标签的类型代码。
disable_replyinteger平台标记评论是否关闭回复的数字值。
like_countsintegerlike_counts 字段返回的点赞数量。
url_objectsarray评论附带的额外链接条目,数组可能为空。
pic_numinteger评论返回的图片数量。
reply_commentobject预览回复所回应的原评论对象。
like_countinteger该回复的 like_count 字段返回的点赞数量。
is_mblog_authorboolean回复作者是否为博文作者。
is_sub_cmtboolean平台是否将该条目标记为子评论。
blogger_iconsarray预览回复作者附带的标记。
blogger_icons[]object一个作者展示标记。
blogger_icons[].namestring作者标记的展示名称。
blogger_icons[].urlstring作者标记关联的链接。
预览回复作者41 个字段

data.data[].comments[]

字段类型说明
userobject预览回复作者的公开主页信息。
user.idinteger微博用户的数字 ID。
user.idstrstring微博用户 ID 的字符串形式。
user.screen_namestring微博用户的展示昵称。
user.profile_image_urlstring用户头像图片链接。
user.avatar_largestring大尺寸头像链接。
user.avatar_hdstring高清头像链接。
user.cover_image_phonestring移动端用户主页的封面图片链接。
user.profile_urlstring微博公开用户主页的路径或链接。
user.domainstring用户主页的自定义地址片段,有数据时提供。
user.weihaostring微博主页微号,可能为空字符串。
user.urlstring用户公开主页上填写的网站链接,可能为空字符串。
user.descriptionstring用户主页展示的简介。
user.locationstring公开用户主页展示的地区。
user.genderstring公开用户主页返回的性别代码。
user.verifiedboolean该用户资料是否带有认证标记。
user.verified_typeinteger用户主页返回的认证类型代码。
user.verified_type_extinteger额外的认证类型代码,有数据时返回。
user.verified_reasonstring用户主页展示的认证说明,有数据时返回。
user.followers_countinteger用户主页返回的粉丝数。
user.followers_count_strstring粉丝数量的展示文本。
user.friends_countinteger该用户关注的账号数量。
user.statuses_countinteger用户主页返回的发博数量。
user.status_total_counterobject用户主页返回的博文互动计数。
user.status_total_counter.total_cnt_formatstring | integer格式化的互动总数,以文本或整数返回。
user.status_total_counter.comment_cntstring主页计数中的评论数,以文本返回。
user.status_total_counter.repost_cntstring主页计数中的转发数,以文本返回。
user.status_total_counter.like_cntstring主页计数中的点赞数,以文本返回。
user.status_total_counter.total_cntstring主页计数中的总数,以文本返回。
user.mbrankinteger用户主页返回的微博会员等级。
user.mbtypeinteger用户主页的平台会员类型代码。
user.svipinteger用户主页返回的 SVIP 数字标记。
user.vvipinteger用户主页返回的 VVIP 数字标记。
user.icon_listarray用户主页展示的图标或标记。
user.icon_list[]object一项用户主页标记或图标。
user.icon_list[].typestring主页图标返回的类型标签。
user.icon_list[].dataobject主页图标的展示和会员信息。
user.icon_list[].data.mbrankinteger图标对应的会员等级。
user.icon_list[].data.mbtypeinteger图标对应的平台会员类型代码。
user.icon_list[].data.svipinteger图标信息中的 SVIP 数字标记。
user.icon_list[].data.vvipinteger图标信息中的 VVIP 数字标记。
被回复的评论11 个字段

data.data[].comments[].reply_comment

字段类型说明
idinteger评论 ID,以整数返回。需要保留完整数字时可用 idstr。
idstrstring评论 ID 的字符串形式。
midstring评论自身的 MID,以字符串返回。请求参数 mid 标识的是博文。
rootidinteger该评论线程的根评论 ID,以整数返回。
rootidstrstring根评论 ID 的字符串形式。
floor_numberinteger线程内返回的评论楼层号。
created_atstring评论发布时间,以平台格式的文本返回。
textstring用于展示的评论内容,可能包含 HTML。
disable_replyinteger平台标记评论是否关闭回复的数字值。
url_objectsarray评论附带的额外链接条目,数组可能为空。
pic_numinteger评论返回的图片数量。
被回复评论的作者45 个字段

data.data[].comments[].reply_comment

字段类型说明
userobject被回复评论作者的公开主页信息。
user.idinteger微博用户的数字 ID。
user.idstrstring微博用户 ID 的字符串形式。
user.screen_namestring微博用户的展示昵称。
user.profile_image_urlstring用户头像图片链接。
user.avatar_largestring大尺寸头像链接。
user.avatar_hdstring高清头像链接。
user.cover_image_phonestring移动端用户主页的封面图片链接。
user.profile_urlstring微博公开用户主页的路径或链接。
user.domainstring用户主页的自定义地址片段,有数据时提供。
user.weihaostring微博主页微号,可能为空字符串。
user.urlstring用户公开主页上填写的网站链接,可能为空字符串。
user.descriptionstring用户主页展示的简介。
user.locationstring公开用户主页展示的地区。
user.genderstring公开用户主页返回的性别代码。
user.verifiedboolean该用户资料是否带有认证标记。
user.verified_typeinteger用户主页返回的认证类型代码。
user.verified_type_extinteger额外的认证类型代码,有数据时返回。
user.verified_reasonstring用户主页展示的认证说明,有数据时返回。
user.followers_countinteger用户主页返回的粉丝数。
user.followers_count_strstring粉丝数量的展示文本。
user.friends_countinteger该用户关注的账号数量。
user.statuses_countinteger用户主页返回的发博数量。
user.status_total_counterobject用户主页返回的博文互动计数。
user.status_total_counter.total_cnt_formatstring | integer格式化的互动总数,以文本或整数返回。
user.status_total_counter.comment_cntstring主页计数中的评论数,以文本返回。
user.status_total_counter.repost_cntstring主页计数中的转发数,以文本返回。
user.status_total_counter.like_cntstring主页计数中的点赞数,以文本返回。
user.status_total_counter.total_cntstring主页计数中的总数,以文本返回。
user.mbrankinteger用户主页返回的微博会员等级。
user.mbtypeinteger用户主页的平台会员类型代码。
user.svipinteger用户主页返回的 SVIP 数字标记。
user.vvipinteger用户主页返回的 VVIP 数字标记。
user.icon_listarray用户主页展示的图标或标记。
user.icon_list[]object一项用户主页标记或图标。
user.icon_list[].typestring主页图标返回的类型标签。
user.icon_list[].dataobject主页图标的展示和会员信息。
user.icon_list[].data.mbrankinteger图标对应的会员等级。
user.icon_list[].data.mbtypeinteger图标对应的平台会员类型代码。
user.icon_list[].data.svipinteger图标信息中的 SVIP 数字标记。
user.icon_list[].data.vvipinteger图标信息中的 VVIP 数字标记。
user.icon_list[].data.valuestring该主页图标返回的文本值。
user.icon_list[].data.icon_imgstring主页图标的图片链接。
user.icon_list[].data.titlestring主页图标的展示标题。
user.icon_list[].data.urlstring主页图标关联的链接。

响应示例 ​

正在加载响应示例…