微博 API - 帖子详情 (V1)

prod-global

GET

/api/weibo/get-weibo-detail/v1

获取指定微博帖子的详细信息，包括完整文本内容、媒体资源（图片/视频）、作者信息、发布时间以及互动指标（点赞、评论和转发）。

典型使用场景：

社交媒体帖子的详细分析
内容归档与监控

请求参数

参数名	位置	类型	必填	说明
`token`	query	`string`	是	API 访问令牌。
`id`	query	`string`	是	微博帖子ID。

代码示例

💡 环境说明

默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见环境选择。

bash

# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/weibo/get-weibo-detail/v1?token=YOUR_API_KEY&id=VALUE"

text

我想使用 Just One API 提供的“帖子详情 (V1)”接口。
接口地址: https://api.justoneapi.com/api/weibo/get-weibo-detail/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/weibo-apis/post-details-v1-zh.json

请求参数说明:
- token (query): API 访问令牌。 (必填)
- id (query): 微博帖子ID。 (必填)

返回格式: JSON

响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败，请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 余额不足

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

python

# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests

url = "https://api.justoneapi.com/api/weibo/get-weibo-detail/v1?token=YOUR_API_KEY&id=VALUE"
response = requests.get(url)
print(response.json())

// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/weibo/get-weibo-detail/v1?token=YOUR_API_KEY&id=VALUE", {
  method: "GET"
});
const data = await response.json();
console.log(data);

java

// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.justoneapi.com/api/weibo/get-weibo-detail/v1?token=YOUR_API_KEY&id=VALUE"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	url := "https://api.justoneapi.com/api/weibo/get-weibo-detail/v1?token=YOUR_API_KEY&id=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

php

// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/weibo/get-weibo-detail/v1?token=YOUR_API_KEY&id=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI 定义 (JSON)]

响应结果

json

{
  "code": 0,
  "data": {
    "hotScheme": "https://m.weibo.cn/p/index?containerid=106003type%3D25%26t%3D3%26disable_hot%3D1%26filter_type%3Drealtimehot&luicode=20000061&lfid=4460302139712164&launchid=10000360-page_H5",
    "appScheme": "https://m.weibo.cn?luicode=20000061&lfid=4460302139712164&launchid=10000360-page_H5",
    "callUinversalLink": false,
    "callWeibo": false,
    "schemeOrigin": false,
    "appLink": "sinaweibo://detail?mblogid=4460302139712164&luicode=20000061&lfid=4460302139712164&launchid=10000360-page_H5",
    "xianzhi_scheme": "xianzhi://mblogshow?mid=4460302139712164",
    "third_scheme": "sinaweibo://detail?mblogid=4460302139712164&luicode=20000061&lfid=4460302139712164&launchid=10000360-page_H5",
    "status": {
      "visible": {
        "type": 0,
        "list_id": 0
      },
      "created_at": "Mon Jan 13 15:59:21 +0800 2020",
      "id": "4460302139712164",
      "mid": "4460302139712164",
      "can_edit": false,
      "text": "正能量的光<span class=\"url-icon\"><img alt=\"[并不简单]\" src=\"https://face.t.sinajs.cn/t4/appstyle/expression/ext/normal/ce/201810_bingbujiandan_mobile.png\" style=\"width:1em; height:1em;\" /></span><br /><a  href=\"https://m.weibo.cn/search?containerid=231522type%3D1%26t%3D10%26q%3D%23%E5%81%A5%E8%BA%AB%23&isnewpage=1&luicode=20000061&lfid=4460302139712164&launchid=10000360-page_H5\" data-hide=\"\"><span class=\"surl-text\">#健身#</span></a> ",
      "textLength": 27,
      "source": "HUAWEI Mate30 Pro 5G",
      "favorited": false,
      "pic_ids": [
        "88899af0gy1gauzlx01irj2184184193",
        "88899af0gy1gauzlxvdezj21bz1tchdu"
      ],
      "thumbnail_pic": "https://wx4.sinaimg.cn/thumbnail/88899af0gy1gauzlx01irj2184184193.jpg",
      "bmiddle_pic": "http://wx4.sinaimg.cn/bmiddle/88899af0gy1gauzlx01irj2184184193.jpg",
      "original_pic": "https://wx4.sinaimg.cn/large/88899af0gy1gauzlx01irj2184184193.jpg",
      "is_paid": false,
      "mblog_vip_type": 0,
      "user": {
        "id": 2290719472,
        "screen_name": "Bella金贝贝",
        "profile_image_url": "https://tvax4.sinaimg.cn/crop.0.0.1080.1080.180/88899af0ly8h3b1vplyvkj20u00u0q5r.jpg?KID=imgbed,tva&Expires=1773076970&ssig=ZF4ppuw%2BrV",
        "profile_url": "https://m.weibo.cn/u/2290719472?luicode=20000061&lfid=4460302139712164&launchid=10000360-page_H5",
        "close_blue_v": false,
        "description": "健身🔟年，是职业更是热爱！ 💃30+辣妈，户外徒步爱好者 📮[email protected]",
        "follow_me": false,
        "following": false,
        "follow_count": 977,
        "followers_count": "35.8万",
        "cover_image_phone": "https://wx1.sinaimg.cn/crop.0.0.640.640.640/88899af0ly1gd01waxbtlj20u00u07i4.jpg",
        "avatar_hd": "https://wx4.sinaimg.cn/orj480/88899af0ly8h3b1vplyvkj20u00u0q5r.jpg",
        "badge": {
          "bind_taobao": 1,
          "unread_pool": 1,
          "unread_pool_ext": 1,
          "dzwbqlx_2016": 1,
          "follow_whitelist_video": 1,
          "user_name_certificate": 1,
          "super_star_2018": 1,
          "wenda_v2": 1,
          "dailv_2018": 1,
          "qixi_2018": 1,
          "suishoupai_2019": 1,
          "hongbao_2020": 2,
          "pc_new": 7,
          "school_2020": 1,
          "aoyun_2021": 1,
          "dailu_2021": 10,
          "hongbaofei2022_2021": 2,
          "gaokao_2022": 1,
          "quanminjianshen_2022": 1,
          "kaixueji_2022": 1,
          "guoqing_2022": 2,
          "hongrenjie_2022": 1,
          "hongrenjienew_2022": 1,
          "chunjiesheyingdasai_2023": 1,
          "muqinjie_2023": 1,
          "gaokao_2023": 1,
          "user_identity_auth": 1,
          "nihaochuntian_2024": 1,
          "biyeji_2024": 1,
          "kaixueji_2024": 1,
          "kxn_2025": 1,
          "fu_2026": 1
        },
        "statuses_count": 3196,
        "verified": true,
        "verified_type": 0,
        "gender": "f",
        "mbtype": 12,
        "svip": 0,
        "urank": 36,
        "mbrank": 7,
        "followers_count_str": "35.8万",
        "verified_type_ext": 0,
        "verified_reason": "运动博主 微博原创视频博主",
        "like": false,
        "like_me": false,
        "special_follow": false,
        "user_token": "a0.MTg1ZGEwZWU0OWVhNGQyYwQsAifWCcUOLQ4lVXUvn8DxYFNIt5GK9j53Hf6s4X49"
      },
      "reposts_count": 71,
      "comments_count": 166,
      "reprint_cmt_count": 0,
      "attitudes_count": 960,
      "mixed_count": 0,
      "pending_approval_count": 0,
      "isLongText": false,
      "show_mlevel": 0,
      "darwin_tags": [],
      "ad_marked": false,
      "mblogtype": 0,
      "item_category": "status",
      "rid": "0_0_0_4867456861430401986_0_0_0",
      "cardid": "star_1189",
      "number_display_strategy": {
        "apply_scenario_flag": 19,
        "display_text_min_number": 1000000,
        "display_text": "100万+"
      },
      "comment_guide_ext": "guide_type:-1|source:1",
      "content_auth": 0,
      "is_show_mixed": false,
      "comment_manage_info": {
        "comment_permission_type": -1,
        "approval_comment_type": 0,
        "comment_sort_type": 0
      },
      "pic_num": 2,
      "mlevel": 0,
      "attitude_dynamic_members_message": {
        "user_grace_setting": {
          "zh_CN": "开学快乐"
        },
        "bgimg": "https://h5.sinaimg.cn/upload/1073/1841/2022/08/24/hihi.png",
        "colorT": "#FFFFFF",
        "portrait": "https://tvax4.sinaimg.cn/crop.0.0.1080.1080.180/88899af0ly8h3b1vplyvkj20u00u0q5r.jpg?KID=imgbed,tva&Expires=1773076970&ssig=ZF4ppuw%2BrV",
        "media_url": "http://tu.video.weibocdn.com/o1/0002R7Kflx07YFisR6da010f020045Vl0E011?Expires=1773069770&ssig=s%2FeNyyvNjD&KID=unistore,video",
        "default_media_url": "http://tu.video.weibocdn.com/o1/0002R7Kflx07YFisR6da010f020045Vl0E011?Expires=1773069770&ssig=s%2FeNyyvNjD&KID=unistore,video",
        "media_id": "4805999014445128",
        "protocol": "",
        "scene_show_option": 3,
        "scheme": "https://new.vip.weibo.cn/attitude/mall?showmenu=0&decorateId=0038",
        "type": 0
      },
      "detail_bottom_bar": 0,
      "page_info": {
        "type": "search_topic",
        "object_type": 0,
        "page_pic": {
          "url": "https://wx4.sinaimg.cn/large/70eb479bly1g71ei9dnbdj20dw0dw7h6.jpg"
        },
        "page_url": "https://m.weibo.cn/search?containerid=231522type%3D1%26t%3D10%26q%3D%23%E5%81%A5%E8%BA%AB%23&isnewpage=1&luicode=20000061&lfid=4460302139712164&launchid=10000360-page_H5",
        "page_title": "#健身#",
        "content1": "0讨论 0阅读 "
      },
      "pics": [
        {
          "pid": "88899af0gy1gauzlx01irj2184184193",
          "url": "https://wx4.sinaimg.cn/orj360/88899af0gy1gauzlx01irj2184184193.jpg",
          "size": "orj360",
          "geo": {
            "width": 360,
            "height": 360,
            "croped": false
          },
          "large": {
            "size": "large",
            "url": "https://wx4.sinaimg.cn/mw2000/88899af0gy1gauzlx01irj2184184193.jpg",
            "geo": {
              "width": "1588",
              "height": "1588",
              "croped": false
            }
          }
        },
        {
          "pid": "88899af0gy1gauzlxvdezj21bz1tchdu",
          "url": "https://wx4.sinaimg.cn/orj360/88899af0gy1gauzlxvdezj21bz1tchdu.jpg",
          "size": "orj360",
          "geo": {
            "width": 360,
            "height": 490,
            "croped": false
          },
          "large": {
            "size": "large",
            "url": "https://wx4.sinaimg.cn/mw2000/88899af0gy1gauzlxvdezj21bz1tchdu.jpg",
            "geo": {
              "width": "1727",
              "height": "2352",
              "croped": false
            }
          }
        }
      ],
      "bid": "IpiJvEKzO",
      "buttons": [
        {
          "type": "follow",
          "name": "关注",
          "sub_type": 0,
          "params": {
            "uid": 2290719472
          }
        }
      ],
      "status_title": "正能量的光#健身# ",
      "ok": 1
    },
    "call": 1
  }
}

💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。

微博 API - 帖子详情 (V1) ​

请求参数 ​

代码示例 ​

响应结果 ​

微博 API - 帖子详情 (V1)

请求参数

代码示例

响应结果