Skip to content

Reddit关键词搜索 API (V1) ​

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

通过关键词搜索Reddit帖子,可选延续令牌。用于发现与主题相关的讨论或继续浏览其他搜索结果页面。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-此 API 服务的访问令牌。
keywordquerystring是-搜索查询关键词。
afterquerystring否用于检索下一组结果的分页令牌。

代码示例 ​

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

请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- keyword (query): 搜索查询关键词。 (必填)
- after (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/reddit/search/v1?token=YOUR_API_KEY&keyword=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/search/v1?token=YOUR_API_KEY&keyword=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/search/v1?token=YOUR_API_KEY&keyword=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/search/v1?token=YOUR_API_KEY&keyword=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/search/v1?token=YOUR_API_KEY&keyword=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)的主要返回字段。

分页4 个字段

data.search.dynamic.components.main.pageInfo

当前搜索页的分页信息。

字段类型说明
endCursorstringhasNextPage 为 true 时,原样传入此游标作为 after,并保持 keyword 不变来请求下一页。
hasNextPagebooleanReddit 是否报告有下一页。
hasPreviousPagebooleanReddit 是否报告有上一页。
startCursorstring当前页起始位置返回的游标。
搜索响应结构5 个字段

data

Reddit 搜索结果与分页信息。

字段类型说明
searchobject搜索结果数据。
search.dynamicobject搜索返回的动态结果数据。
search.dynamic.componentsobject搜索结果返回的组件信息。
search.dynamic.components.__typenamestring搜索组件对象的 GraphQL 类型名称。
search.dynamic.components.mainobject主要结果集合,包含结果条目和分页信息。
搜索结果组件8 个字段

data.search.dynamic.components.main

字段类型说明
edgesarray本页返回的结果条目,可能包含列表、行或其他搜索组件。
edges[]object一个搜索结果条目。
edges[].cursorstring此结果条目返回的游标。
edges[].nodeobject此条目中的搜索组件,部分组件类型包含帖子结果。
edges[].node.__typenamestring用于识别搜索组件类型的 GraphQL 类型名称。
edges[].node.childrenarray组件包含的子结果,可能省略。
edges[].node.children[]object一项子结果。帖子结果包含 post 对象。
edges[].node.children[].__typenamestring用于识别子结果类型的 GraphQL 类型名称。
搜索筛选条件6 个字段

data.search.dynamic.components

字段类型说明
appliedStateobject此响应返回的搜索筛选条件和结果分类。
appliedState.filtersarray平台返回的已应用搜索筛选条件。
appliedState.filters[]object一项平台返回的搜索筛选条件。
appliedState.filters[].keystring此筛选条件的名称。
appliedState.filters[].valuestring此筛选条件的值。
appliedState.panestring平台返回的搜索结果分类。
帖子信息15 个字段

data.search.dynamic.components.main.edges[].node.children[].post

帖子结果中的帖子信息,可能省略。

字段类型说明
__typenamestring帖子对象的 GraphQL 类型名称。
createdAtstring帖子创建时间,以字符串返回。Reddit 返回的时区偏移可能省略冒号。
domainstringReddit 返回的帖子域名标签。
editedAtstring | null可用时返回帖子编辑时间。
idstringReddit 完整帖子 ID,包含 t3_ 前缀。
languageCodestring | nullReddit 返回的帖子语言代码。
permalinkstring此帖子在 Reddit 上的相对永久链接路径。
postHintstring | null可用时返回 Reddit 报告的帖子展示类型提示。
postTitlestringReddit 返回的帖子标题。
thumbnailobject | null帖子返回的缩略图。
thumbnail.dimensionsobject图片或播放器尺寸,单位为像素。
thumbnail.dimensions.heightinteger高度,单位为像素。
thumbnail.dimensions.widthinteger宽度,单位为像素。
thumbnail.urlstring缩略图地址。
urlstring帖子关联的地址。
帖子正文12 个字段

data.search.dynamic.components.main.edges[].node.children[].post.content

Reddit 提供时返回帖子正文,字段值可以为 null。

字段类型说明
htmlstringReddit 提供时返回 HTML 格式正文。
markdownstringReddit 返回的 Markdown 格式正文。
previewstringReddit 提供时返回正文预览。
richtextstring可用时返回序列化为字符串的 Reddit 富文本。
richtextMediaarray帖子正文富文本引用的媒体列表。
richtextMedia[]object帖子正文引用的一项媒体。
richtextMedia[].heightinteger此媒体项的高度,单位为像素。
richtextMedia[].idstring帖子正文中的媒体 ID。
richtextMedia[].mimetypestring帖子正文中此媒体项的 MIME 类型。
richtextMedia[].statusstring平台返回的正文媒体项状态。
richtextMedia[].urlstring帖子正文中此媒体项的地址。
richtextMedia[].widthinteger此媒体项的宽度,单位为像素。
作者资料与标识25 个字段

data.search.dynamic.components.main.edges[].node.children[].post

字段类型说明
authorFlairobject | null可用时返回的作者在此版块中的用户标识。
authorFlair.richtextstring | null可用时返回的作者标识序列化富文本。
authorFlair.textstring作者标识的展示文字。
authorInfoobject帖子作者的公开资料。
authorInfo.accountTypestringReddit 返回的作者账号类型。
authorInfo.iconSmallobject作者的小尺寸头像图。
authorInfo.iconSmall.dimensionsobject图片尺寸,单位为像素。
authorInfo.iconSmall.dimensions.heightinteger高度,单位为像素。
authorInfo.iconSmall.dimensions.widthinteger宽度,单位为像素。
authorInfo.iconSmall.urlstring图片链接。
authorInfo.idstring帖子作者的 Reddit 完整 ID。
authorInfo.isCakeDayNowbooleanReddit 是否标记当天为作者的账号周年日。
authorInfo.namestring作者的 Reddit 公开用户名。
authorInfo.newIconobject新版头像字段返回的作者头像图。
authorInfo.newIcon.dimensionsobject图片尺寸,单位为像素。
authorInfo.newIcon.dimensions.heightinteger高度,单位为像素。
authorInfo.newIcon.dimensions.widthinteger宽度,单位为像素。
authorInfo.newIcon.urlstring图片链接。
authorInfo.profileobject与作者关联的公开 Reddit 资料。
authorInfo.profile.isNsfwbooleanReddit 是否将作者的资料标记为 NSFW。
authorInfo.snoovatarIconobject | null可用时返回的作者 Snoovatar 头像图。
authorInfo.snoovatarIcon.dimensionsobject图片尺寸,单位为像素。
authorInfo.snoovatarIcon.dimensions.heightinteger高度,单位为像素。
authorInfo.snoovatarIcon.dimensions.widthinteger宽度,单位为像素。
authorInfo.snoovatarIcon.urlstring图片链接。
版块信息8 个字段

data.search.dynamic.components.main.edges[].node.children[].post.subreddit

此区块返回时,表示帖子所属的社区。

字段类型说明
idstringReddit 社区 ID。
isNsfwbooleanReddit 是否将此社区标记为 NSFW。
isQuarantinedbooleanReddit 是否将此社区标记为已隔离。
namestring社区名称。
prefixedNamestring带 Reddit 前缀的社区名称。
subscribersCountintegerReddit 报告的社区订阅人数。
titlestring社区展示标题。
typestringReddit 返回的社区类型。
帖子标记与权限17 个字段

data.search.dynamic.components.main.edges[].node.children[].post

字段类型说明
flairobject | null可用时返回帖子标签。
flair.richtextstring | null可用时返回的帖子标识序列化富文本。
flair.textstring帖子标签的展示文字。
flair.typestringReddit 返回的帖子标签类型。
isArchivedbooleanReddit 是否将此帖标记为已归档。
isCommercialCommunicationbooleanReddit 是否将帖子标记为商业推广内容。
isContestModebooleanReddit 是否将帖子标记为竞赛模式。
isCrosspostablebooleanReddit 是否标记该帖子可跨版块转发。
isLockedbooleanReddit 是否将此帖标记为已锁定。
isNsfwbooleanReddit 是否将此帖标记为 NSFW 内容。
isPollIncludedbooleanReddit 是否标记帖子包含投票。
isScoreHiddenbooleanReddit 是否将此帖的得分标记为隐藏。
isSelfPostbooleanReddit 是否将其标记为站内帖。
isSpoilerbooleanReddit 是否将此帖标记为含有剧透。
isStickiedbooleanReddit 是否将此帖标记为置顶。
isTranslatablebooleanReddit 是否标记帖子可翻译。
isTranslatedbooleanReddit 是否将返回的帖子标记为已翻译。
互动数据10 个字段

data.search.dynamic.components.main.edges[].node.children[].post

字段类型说明
awardingsarray帖子返回的获奖记录。
awardings[]object一种奖励及其获得次数。
awardings[].awardobject此奖励类型的公开信息。
awardings[].award.idstringReddit 奖励 ID。
awardings[].award.namestring奖励展示名称。
awardings[].totalintegerReddit 报告的该帖子获得此奖励的次数。
commentCountinteger平台返回的帖子评论数。
scoreintegerReddit 报告的帖子得分。
suggestedCommentSortstring | null可用时返回评论的建议展示顺序。
upvoteRationumberReddit 报告的帖子赞成票比例,以 0 到 1 的数值返回。
帖子图片35 个字段

data.search.dynamic.components.main.edges[].node.children[].post.media.still

帖子中的静态图片,包括原图和不同尺寸的版本。

字段类型说明
largeobject | null大尺寸图片版本。
large.dimensionsobject图片或播放器尺寸,单位为像素。
large.dimensions.heightinteger高度,单位为像素。
large.dimensions.widthinteger宽度,单位为像素。
large.urlstring静态图片地址。
mediumobject | null中等尺寸图片版本。
medium.dimensionsobject图片或播放器尺寸,单位为像素。
medium.dimensions.heightinteger高度,单位为像素。
medium.dimensions.widthinteger宽度,单位为像素。
medium.urlstring静态图片地址。
smallobject | null小尺寸图片版本。
small.dimensionsobject图片或播放器尺寸,单位为像素。
small.dimensions.heightinteger高度,单位为像素。
small.dimensions.widthinteger宽度,单位为像素。
small.urlstring静态图片地址。
sourceobject静态原图。
source.dimensionsobject图片或播放器尺寸,单位为像素。
source.dimensions.heightinteger高度,单位为像素。
source.dimensions.widthinteger宽度,单位为像素。
source.urlstring静态图片地址。
xlargeobject | null加大尺寸图片版本。
xlarge.dimensionsobject图片或播放器尺寸,单位为像素。
xlarge.dimensions.heightinteger高度,单位为像素。
xlarge.dimensions.widthinteger宽度,单位为像素。
xlarge.urlstring静态图片地址。
xxlargeobject | null超大尺寸图片版本。
xxlarge.dimensionsobject图片或播放器尺寸,单位为像素。
xxlarge.dimensions.heightinteger高度,单位为像素。
xxlarge.dimensions.widthinteger宽度,单位为像素。
xxlarge.urlstring静态图片地址。
xxxlargeobject | null特大尺寸图片版本。
xxxlarge.dimensionsobject图片或播放器尺寸,单位为像素。
xxxlarge.dimensions.heightinteger高度,单位为像素。
xxxlarge.dimensions.widthinteger宽度,单位为像素。
xxxlarge.urlstring静态图片地址。
视频播放与下载23 个字段

data.search.dynamic.components.main.edges[].node.children[].post.media

可用时返回随帖子提供的媒体。相册媒体有独立的返回结构。

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

data.search.dynamic.components.main.edges[].node.children[].post.gallery

可用时返回帖子相册。

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

响应示例 ​

正在加载响应示例…