Reddit 用户帖子
curl --request POST \
--url https://api.socq.ai/v1/reddit/user-posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"username": "<string>",
"callback_url": "<string>",
"results_limit": 25,
"sort_by": "new"
}
'import requests
url = "https://api.socq.ai/v1/reddit/user-posts"
payload = {
"username": "<string>",
"callback_url": "<string>",
"results_limit": 25,
"sort_by": "new"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
username: '<string>',
callback_url: '<string>',
results_limit: 25,
sort_by: 'new'
})
};
fetch('https://api.socq.ai/v1/reddit/user-posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/reddit/user-posts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'username' => '<string>',
'callback_url' => '<string>',
'results_limit' => 25,
'sort_by' => 'new'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/reddit/user-posts"
payload := strings.NewReader("{\n \"username\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 25,\n \"sort_by\": \"new\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/reddit/user-posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"username\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 25,\n \"sort_by\": \"new\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/reddit/user-posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"username\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 25,\n \"sort_by\": \"new\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Reddit
Reddit 用户帖子
获取 Reddit 账号发布过的帖子。
POST
/
v1
/
reddit
/
user-posts
Reddit 用户帖子
curl --request POST \
--url https://api.socq.ai/v1/reddit/user-posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"username": "<string>",
"callback_url": "<string>",
"results_limit": 25,
"sort_by": "new"
}
'import requests
url = "https://api.socq.ai/v1/reddit/user-posts"
payload = {
"username": "<string>",
"callback_url": "<string>",
"results_limit": 25,
"sort_by": "new"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
username: '<string>',
callback_url: '<string>',
results_limit: 25,
sort_by: 'new'
})
};
fetch('https://api.socq.ai/v1/reddit/user-posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/reddit/user-posts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'username' => '<string>',
'callback_url' => '<string>',
'results_limit' => 25,
'sort_by' => 'new'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/reddit/user-posts"
payload := strings.NewReader("{\n \"username\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 25,\n \"sort_by\": \"new\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/reddit/user-posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"username\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 25,\n \"sort_by\": \"new\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/reddit/user-posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"username\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 25,\n \"sort_by\": \"new\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Reddit 用户帖子
拉取一个 Reddit 用户发过的所有帖子:文字帖的完整正文、帖子链接、分数、评论数、发布时间,以及帖子里的图片和视频。按最新排序可以跟踪对方最近在分享什么,按热度排序可以看哪些帖子反响最好。适合做创作者调研、盯创始人账号的品牌动态,或者把某位行业专家的长帖整理成数据集。{
"username": "spez",
"sort_by": "new",
"results_limit": 25
}
标准结果字段
任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。
| 字段 | 类型 | 可空 | 说明 |
|---|---|---|---|
id | string | 是 | 当前结果项的唯一标识。 |
platform | string | 否 | 结果所属的平台,例如 instagram 或 linkedin。 |
resource | string | 否 | 该结果对应的 SocQ 资源,例如 videos 或 comments。 |
type | string | 否 | 结果项的类别,例如 video、post 或 comment。 |
url | string | 是 | 结果项的公开访问地址(如可获得)。 |
published_at | string | 是 | 源内容的发布时间(如可获得),使用 ISO 8601 格式。 |
collected_at | string | 否 | SocQ 采集或处理该结果的时间,使用 ISO 8601 格式。 |
text | string | 是 | 帖子的正文、说明文字或消息内容。 |
author | object | 是 | 内容的作者或发布者。 |
author.id | string | 是 | 作者的唯一标识。 |
author.username | string | 是 | 账号的公开用户名或账号标识。 |
author.name | string | 是 | 作者的显示名称。 |
author.url | string | 是 | 作者的公开访问地址(如可获得)。 |
author.avatar_url | string | 是 | 账号头像图片的地址。 |
author.is_verified | boolean | 是 | 账号是否已通过平台认证。 |
author.is_private | boolean | 是 | 账号是否为私密账号。 |
metrics | object | 是 | 结果项可获得的计数和度量数据。 |
metrics.likes_count | integer | 是 | 点赞数量。 |
metrics.comments_count | integer | 是 | 评论数量。 |
metrics.shares_count | integer | 是 | 分享或转发数量。 |
metrics.views_count | integer | 是 | 平台报告的观看数量。 |
media | array<object> | 是 | 结果附带的图片、视频或其他媒体。 |
media.type | string | 是 | 媒体类型,例如 image 或 video。 |
media.url | string | 是 | 媒体文件的地址。 |
media.thumbnail_url | string | 是 | 媒体预览图的地址。 |
media.width | integer | 是 | 媒体宽度,单位为像素。 |
media.height | integer | 是 | 媒体高度,单位为像素。 |
media.duration_seconds | number | 是 | 媒体时长,单位为秒。 |
hashtags | array<string> | 是 | 内容关联的话题标签,保留源数据中的拼写。 |
mentions | array<string> | 是 | 内容中提及的账号。 |
任务完成响应
{
"code": 200,
"data": {
"task_id": "example-reddit-user-posts",
"status": "succeeded",
"public_id": "reddit/user-posts",
"result_count": 1,
"credits_amount": 0.5,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "post",
"schema_version": "1.0",
"items": [
{
"id": "1xiupm0",
"platform": "reddit",
"resource": "user-posts",
"type": "post",
"url": "https://www.reddit.com/user/spez/comments/1xiupm0/about_that_login_screen/",
"published_at": "2026-10-29T20:08:37.416000Z",
"collected_at": "2026-11-17T14:40:28.299773Z",
"text": "About that login screen\n\nI want to talk about a big change we're making on Reddit: we're going to evolve Reddit to being a primarily logged-in experience.\n\nThis is a big change for Reddit, where we've allowed logged-out access to basically all of Reddit for the last two decades. And I don’t know about you, but as someone whose life has been defined by the open internet, it’s a big change for me. But I've come to the conclusion that this is the right decision for our platform and the right decision for our business. I wanted you all to hear directly from me about why.\n\nTL;DR We’re making the change because it’s better for user experience, better for our ads business, is more in line with safety regulations, and more protective of Reddit data. And we can do this while continuing to ensure user privacy. \n\n**For users to get the best version of Reddit, it requires personalization.** …",
"author": {
"id": "t2_1w72",
"username": "spez",
"name": "spez",
"url": "https://www.reddit.com/user/spez/",
"avatar_url": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=50&height=50&frame=1&auto=webp&crop=50%3A50%2Csmart&s=638708ec49d2051716871e62d0b8a9da3b11402c",
"is_verified": null,
"is_private": null
},
"metrics": {
"likes_count": 0,
"comments_count": 510,
"shares_count": null,
"views_count": null
},
"media": [],
"hashtags": null,
"mentions": null
}
]
}
}
}
请求体
application/json
通过 username 提供一个 Reddit 用户名。sort_by 可选 new(默认,最新)、top(最高分)或 hot(热门)。results_limit 默认 25,可填 1–1000 之间的整数。每条帖子计 0.5 积分;likes_count 为帖子分数。

