Skip to content

Reddit帖子详情 API (V1) ​

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

通过完整帖子ID获取Reddit帖子的详情。用于在讨论审查、内容分析或后续评论获取之前查找已知帖子。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-此 API 服务的访问令牌。
postIdquerystring是-Reddit帖子标识符,格式为t3_<post-id>。

代码示例 ​

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

请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- postId (query): Reddit帖子标识符,格式为t3_<post-id>。 (必填)

返回格式: 请根据实际 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/reddit/get-post-detail/v1?token=YOUR_API_KEY&postId=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/reddit/get-post-detail/v1?token=YOUR_API_KEY&postId=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/reddit/get-post-detail/v1?token=YOUR_API_KEY&postId=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/reddit/get-post-detail/v1?token=YOUR_API_KEY&postId=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/reddit/get-post-detail/v1?token=YOUR_API_KEY&postId=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)的主要返回字段。

帖子基础信息7 个字段

data.postsInfoByIds[]

帖子查询结果。查询不到对应帖子时,数组中可能返回一个 null 元素。

字段类型说明
idstringReddit 完整帖子 ID,包含 t3_ 前缀。
postTitlestringReddit 返回的帖子标题。
permalinkstring此帖子在 Reddit 上的相对永久链接路径。
createdAtstring帖子创建时间,以字符串返回。Reddit 返回的时区偏移可能省略冒号。
editedAtstring | null可用时返回帖子编辑时间。
languageCodestringReddit 返回的帖子语言代码。
isSelfPostbooleanReddit 是否将其标记为站内帖。
正文与外链10 个字段

data.postsInfoByIds[]

字段类型说明
urlstring帖子关联的地址。
domainstringReddit 返回的帖子域名标签。
contentobject | nullReddit 提供时返回帖子正文,字段值可以为 null。
content.markdownstringReddit 返回的 Markdown 格式正文。
content.htmlstring | nullReddit 提供时返回 HTML 格式正文。
content.previewstring | nullReddit 提供时返回正文预览。
content.richtextstring | null可用时返回序列化为字符串的 Reddit 富文本。
outboundLinkobject此帖返回的外链信息。
outboundLink.urlstringReddit 返回的外链地址。
outboundLink.expiresAtstring此外链对应的到期时间。
作者与社区18 个字段

data.postsInfoByIds[]

字段类型说明
authorInfoobject帖子作者的公开资料。
authorInfo.idstring帖子作者的 Reddit 完整 ID。
authorInfo.namestring作者的 Reddit 公开用户名。
authorInfo.accountTypestringReddit 返回的作者账号类型。
subredditobject此区块返回时,表示帖子所属的社区。
subreddit.idstringReddit 社区 ID。
subreddit.namestring社区名称。
subreddit.prefixedNamestring带 Reddit 前缀的社区名称。
subreddit.titlestring社区展示标题。
subreddit.typestringReddit 返回的社区类型。
subreddit.subscribersCountnumberReddit 报告的社区订阅人数。
subreddit.isNsfwbooleanReddit 是否将此社区标记为 NSFW。
subreddit.isQuarantinedbooleanReddit 是否将此社区标记为已隔离。
profileobject此区块返回时,表示发布帖子的 Reddit 个人主页。
profile.idstringReddit 个人主页 ID。
profile.namestringReddit 个人主页的名称。
profile.subscribersCountnumberReddit 报告的个人主页订阅人数。
profile.isNsfwbooleanReddit 是否将此个人主页标记为 NSFW。
互动与奖励11 个字段

data.postsInfoByIds[]

字段类型说明
scoreintegerReddit 报告的帖子得分。
upvoteRationumberReddit 报告的帖子赞成票比例,以 0 到 1 的数值返回。
commentCountinteger平台返回的帖子评论数。
postStatsobjectReddit 返回的帖子公开统计。
postStats.shareAllTotalintegerReddit 报告的帖子分享总数。
awardingsarray帖子返回的获奖记录。
awardings[]object一种奖励及其获得次数。
awardings[].totalintegerReddit 报告的该帖子获得此奖励的次数。
awardings[].awardobject此奖励类型的公开信息。
awardings[].award.idstringReddit 奖励 ID。
awardings[].award.namestring奖励展示名称。
视频流与下载22 个字段

data.postsInfoByIds[].media

字段类型说明
streamingobject | nullReddit 提供时返回流媒体信息。
streaming.hlsUrlstringHLS 流媒体清单地址。
streaming.dashUrlstringDASH 流媒体清单地址。
streaming.dimensionsobject图片或播放器尺寸,单位为像素。
streaming.dimensions.widthinteger宽度,单位为像素。
streaming.dimensions.heightinteger高度,单位为像素。
streaming.durationintegerReddit 返回的流媒体时长数值。
streaming.isGifbooleanReddit 是否将该流标记为 GIF 式动画。
downloadobject | nullReddit 提供时返回下载信息。
download.urlstringReddit 返回的媒体下载地址。
packagedMediaobject | nullReddit 提供时返回封装后的媒体信息。
packagedMedia.muxedMp4sobject按画质返回的封装 MP4 版本。
packagedMedia.muxedMp4s.lowobject低画质 MP4 版本。
packagedMedia.muxedMp4s.low.urlstring封装后的 MP4 地址。
packagedMedia.muxedMp4s.mediumobject中等画质 MP4 版本。
packagedMedia.muxedMp4s.medium.urlstring封装后的 MP4 地址。
packagedMedia.muxedMp4s.highobject高画质 MP4 版本。
packagedMedia.muxedMp4s.high.urlstring封装后的 MP4 地址。
packagedMedia.muxedMp4s.highestobject此集合返回的最高画质 MP4 版本。
packagedMedia.muxedMp4s.highest.urlstring封装后的 MP4 地址。
packagedMedia.muxedMp4s.recommendedobjectReddit 推荐的 MP4 版本。
packagedMedia.muxedMp4s.recommended.urlstring封装后的 MP4 地址。
图片与缩略图43 个字段

data.postsInfoByIds[]

字段类型说明
mediaobject | null可用时返回随帖子提供的媒体。相册媒体有独立的返回结构。
media.typeHintstring | null可用时返回 Reddit 报告的媒体类型提示。
media.stillobject帖子中的静态图片,包括原图和不同尺寸的版本。
media.still.sourceobject静态原图。
media.still.source.urlstring静态图片地址。
media.still.source.dimensionsobject图片或播放器尺寸,单位为像素。
media.still.source.dimensions.widthinteger宽度,单位为像素。
media.still.source.dimensions.heightinteger高度,单位为像素。
media.still.smallobject小尺寸图片版本。
media.still.small.urlstring静态图片地址。
media.still.small.dimensionsobject图片或播放器尺寸,单位为像素。
media.still.small.dimensions.widthinteger宽度,单位为像素。
media.still.small.dimensions.heightinteger高度,单位为像素。
media.still.mediumobject中等尺寸图片版本。
media.still.medium.urlstring静态图片地址。
media.still.medium.dimensionsobject图片或播放器尺寸,单位为像素。
media.still.medium.dimensions.widthinteger宽度,单位为像素。
media.still.medium.dimensions.heightinteger高度,单位为像素。
media.still.largeobject大尺寸图片版本。
media.still.large.urlstring静态图片地址。
media.still.large.dimensionsobject图片或播放器尺寸,单位为像素。
media.still.large.dimensions.widthinteger宽度,单位为像素。
media.still.large.dimensions.heightinteger高度,单位为像素。
media.still.xlargeobject加大尺寸图片版本。
media.still.xlarge.urlstring静态图片地址。
media.still.xlarge.dimensionsobject图片或播放器尺寸,单位为像素。
media.still.xlarge.dimensions.widthinteger宽度,单位为像素。
media.still.xlarge.dimensions.heightinteger高度,单位为像素。
media.still.xxlargeobject超大尺寸图片版本。
media.still.xxlarge.urlstring静态图片地址。
media.still.xxlarge.dimensionsobject图片或播放器尺寸,单位为像素。
media.still.xxlarge.dimensions.widthinteger宽度,单位为像素。
media.still.xxlarge.dimensions.heightinteger高度,单位为像素。
media.still.xxxlargeobject特大尺寸图片版本。
media.still.xxxlarge.urlstring静态图片地址。
media.still.xxxlarge.dimensionsobject图片或播放器尺寸,单位为像素。
media.still.xxxlarge.dimensions.widthinteger宽度,单位为像素。
media.still.xxxlarge.dimensions.heightinteger高度,单位为像素。
thumbnailobject | null帖子返回的缩略图。
thumbnail.urlstring缩略图地址。
thumbnail.dimensionsobject图片或播放器尺寸,单位为像素。
thumbnail.dimensions.widthinteger宽度,单位为像素。
thumbnail.dimensions.heightinteger高度,单位为像素。
相册40 个字段

data.postsInfoByIds[]

字段类型说明
galleryobject | null可用时返回帖子相册。
gallery.itemsarray相册中的媒体条目。
gallery.items[]object一条相册媒体记录。
gallery.items[].idstring相册条目的 ID。
gallery.items[].mediaobject此相册条目的媒体数据。
gallery.items[].media.idstring相册媒体的 Reddit ID。
gallery.items[].media.mimetypestring相册媒体的 MIME 类型。
gallery.items[].media.urlstring相册媒体的地址。
gallery.items[].media.widthinteger相册媒体宽度,单位为像素。
gallery.items[].media.heightinteger相册媒体高度,单位为像素。
gallery.items[].media.smallobject小尺寸图片版本。
gallery.items[].media.small.urlstring静态图片地址。
gallery.items[].media.small.dimensionsobject图片或播放器尺寸,单位为像素。
gallery.items[].media.small.dimensions.widthinteger宽度,单位为像素。
gallery.items[].media.small.dimensions.heightinteger高度,单位为像素。
gallery.items[].media.mediumobject中等尺寸图片版本。
gallery.items[].media.medium.urlstring静态图片地址。
gallery.items[].media.medium.dimensionsobject图片或播放器尺寸,单位为像素。
gallery.items[].media.medium.dimensions.widthinteger宽度,单位为像素。
gallery.items[].media.medium.dimensions.heightinteger高度,单位为像素。
gallery.items[].media.largeobject大尺寸图片版本。
gallery.items[].media.large.urlstring静态图片地址。
gallery.items[].media.large.dimensionsobject图片或播放器尺寸,单位为像素。
gallery.items[].media.large.dimensions.widthinteger宽度,单位为像素。
gallery.items[].media.large.dimensions.heightinteger高度,单位为像素。
gallery.items[].media.xlargeobject加大尺寸图片版本。
gallery.items[].media.xlarge.urlstring静态图片地址。
gallery.items[].media.xlarge.dimensionsobject图片或播放器尺寸,单位为像素。
gallery.items[].media.xlarge.dimensions.widthinteger宽度,单位为像素。
gallery.items[].media.xlarge.dimensions.heightinteger高度,单位为像素。
gallery.items[].media.xxlargeobject超大尺寸图片版本。
gallery.items[].media.xxlarge.urlstring静态图片地址。
gallery.items[].media.xxlarge.dimensionsobject图片或播放器尺寸,单位为像素。
gallery.items[].media.xxlarge.dimensions.widthinteger宽度,单位为像素。
gallery.items[].media.xxlarge.dimensions.heightinteger高度,单位为像素。
gallery.items[].media.xxxlargeobject特大尺寸图片版本。
gallery.items[].media.xxxlarge.urlstring静态图片地址。
gallery.items[].media.xxxlarge.dimensionsobject图片或播放器尺寸,单位为像素。
gallery.items[].media.xxxlarge.dimensions.widthinteger宽度,单位为像素。
gallery.items[].media.xxxlarge.dimensions.heightinteger高度,单位为像素。
状态与展示标记12 个字段

data.postsInfoByIds[]

可用时返回 Reddit 帖子详情。查询成功时也可能返回 null。

字段类型说明
isNsfwbooleanReddit 是否将此帖标记为 NSFW 内容。
isSpoilerbooleanReddit 是否将此帖标记为含有剧透。
isArchivedbooleanReddit 是否将此帖标记为已归档。
isLockedbooleanReddit 是否将此帖标记为已锁定。
isStickiedbooleanReddit 是否将此帖标记为置顶。
isScoreHiddenbooleanReddit 是否将此帖的得分标记为隐藏。
removedByCategorystring | null可用时返回 Reddit 报告的移除类别。被移除的帖子仍可能返回正文对象。
postHintstring | null可用时返回 Reddit 报告的帖子展示类型提示。
suggestedCommentSortstring | null可用时返回评论的建议展示顺序。
flairobject | null可用时返回帖子标签。
flair.textstring帖子标签的展示文字。
flair.typestringReddit 返回的帖子标签类型。

响应示例 ​

正在加载响应示例…