Reddit Answers API
curl --request POST \
--url https://api.socq.ai/v1/reddit/answers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/reddit/answers"
payload = {
"query": "<string>",
"callback_url": "<string>"
}
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({query: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/reddit/answers', 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/answers",
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([
'query' => '<string>',
'callback_url' => '<string>'
]),
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/answers"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\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/answers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/reddit/answers")
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 \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\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 Answers
Ask Reddit Answers a question and get the answer with the comments and posts it cites.
POST
/
v1
/
reddit
/
answers
Reddit Answers API
curl --request POST \
--url https://api.socq.ai/v1/reddit/answers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/reddit/answers"
payload = {
"query": "<string>",
"callback_url": "<string>"
}
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({query: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/reddit/answers', 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/answers",
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([
'query' => '<string>',
'callback_url' => '<string>'
]),
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/answers"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\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/answers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/reddit/answers")
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 \"query\": \"<string>\",\n \"callback_url\": \"<string>\"\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 Answers
Ask Reddit Answers, Reddit’s AI search, a question and get back the answer it builds from Reddit discussions. Each task returns one answer: a one-line summary, the full Markdown response, the comments it quotes with links, the posts it draws on with their titles, scores and comment counts, the subreddits Reddit recommends for the topic and the follow-up questions it suggests. Use it to learn what Reddit users recommend, see which threads and communities shape the answer for a product or brand, or feed grounded Reddit opinions into research and AI workflows.{
"query": "what do people say about standing desks for back pain"
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | Reddit Answers conversation ID. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | Link to the answer on Reddit Answers. |
published_at | string | Yes | Time the answer was generated, in ISO 8601 format. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
query | string | Yes | Question that was asked. |
summary | string | Yes | One-sentence answer that opens the response. |
answer | string | Yes | Full answer in Markdown, with headings, bullet points and quoted comments linked to Reddit. |
citations | array<object> | Yes | Comments and posts quoted in the answer. |
citations.text | string | Yes | Quoted text. |
citations.url | string | Yes | Link to the quoted comment or post. |
citations.subreddit | string | Yes | Subreddit of the quoted comment or post, without r/. |
citations.source_type | string | Yes | Kind of quoted source: comment or post. |
source_posts | array<object> | Yes | Reddit posts the answer draws on. |
source_posts.id | string | Yes | Reddit post ID. |
source_posts.url | string | Yes | Link to the post. |
source_posts.title | string | Yes | Title of the post. |
source_posts.text | string | Yes | Body text of the post. |
source_posts.subreddit | string | Yes | Subreddit of the post, without r/. |
source_posts.author_username | string | Yes | Username of the post author. |
source_posts.score | integer | Yes | Score of the post (upvotes minus downvotes). |
source_posts.comments_count | integer | Yes | Number of comments on the post. |
source_posts.published_at | string | Yes | Time the post was published, in ISO 8601 format. |
recommended_subreddits | array<object> | Yes | Subreddits Reddit recommends for the question. |
recommended_subreddits.name | string | Yes | Name of the subreddit, without r/. |
recommended_subreddits.url | string | Yes | Link to the subreddit. |
recommended_subreddits.title | string | Yes | Title of the subreddit. |
recommended_subreddits.description | string | Yes | Public description of the subreddit. |
recommended_subreddits.members_count | integer | Yes | Number of members of the subreddit. |
follow_up_queries | array<string> | Yes | Follow-up questions Reddit suggests after the answer. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-reddit-answers",
"status": "succeeded",
"public_id": "reddit/answers",
"result_count": 1,
"credits_amount": 6,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "reddit-answer",
"schema_version": "1.0",
"items": [
{
"id": "6f3dc9a1-d47b-49b2-a063-28cc8a0f96ce",
"platform": "reddit",
"resource": "answers",
"type": "answer",
"url": "https://www.reddit.com/answers/6f3dc9a1-d47b-49b2-a063-28cc8a0f96ce/?q=what+do+people+say+about+standing+desks+for+back+pain",
"published_at": "2026-11-20T08:10:24Z",
"collected_at": "2026-11-20T08:10:39Z",
"query": "what do people say about standing desks for back pain",
"summary": "People on Reddit generally say changing positions helps more than standing alone, though some report real relief and others find prolonged standing uncomfortable.",
"answer": "People on Reddit generally say **changing positions helps more than standing alone**, though some report real relief and others find prolonged standing uncomfortable.\n\n### What people say helps\n\n> One of the biggest thing that helped me was not doing either for too long.",
"citations": [
{
"text": "Yes, just switch between sitting and standing every 45ish minutes or so. There is a big difference from being sedentary all day.",
"url": "https://www.reddit.com/r/StandingDesk/comments/1vy645v/comment/p5udbyx/",
"subreddit": "StandingDesk",
"source_type": "comment"
}
],
"source_posts": [
{
"id": "12658mg",
"url": "https://www.reddit.com/r/backpain/comments/12658mg/do_you_recommend_a_standing_desk/",
"title": "Do you recommend a standing desk?",
"text": "I got diagnosed with bulging disc at L4/5 and still recovering.",
"subreddit": "backpain",
"author_username": "shootingstars00987",
"score": 18,
"comments_count": 27,
"published_at": "2023-03-30T00:00:10Z"
}
],
"recommended_subreddits": [
{
"name": "StandingDesk",
"url": "https://www.reddit.com/r/StandingDesk/",
"title": "Standing Desks",
"description": "StandingDesk stands (heh) against Reddit corporate takeovers",
"members_count": 68505
}
],
"follow_up_queries": [
"standing desk vs walking pad back pain",
"how often switch between sitting and standing"
]
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide a question in query, written as you would ask it on Reddit Answers. Returns one answer summarized from Reddit discussions, with the quoted comments, the posts it draws on, recommended subreddits and follow-up questions.

