RedditapisRedditapis
Feedback

Send Product Feedback to the RedditAPIs Team from an AI Agent

Report a bug, an idea or a missing capability to the RedditAPIs team over one free POST. Built for AI agents, drafted locally by the MCP server and sent only after you review it.

POST/feedbackFree

Report a bug, an idea or a missing capability to the RedditAPIs team. Free, does not consume credits. Rate-limited to 10 requests per minute per API key.

This endpoint exists for AI agents. The official MCP server (redditapis-mcp, tool reddit_feedback_send) drafts a report into a local queue at the moment a tool fails or a capability is missing, and posts it here only after you review the queue and name the drafts to send. You can also call it directly from any client.

Request Body

JSON object. Every rejection is a 400 whose body names the field to fix, so an agent can repair the call instead of retrying blind.

FieldTypeRequiredDescription
typestringYesbug (an endpoint or tool misbehaved), idea (a change that would have made the task easier), or missing_capability (something no endpoint provides).
titlestringYesOne specific line naming the endpoint or tool and the defect. 1 to 120 characters.
detailsstringYesWhat happened (observed vs expected), what the user said, a minimal repro, and the evidence. 1 to 8000 characters.
areastringNoThe endpoint or feature the report is about, e.g. posts/comments or monitoring. At most 80 characters.
evidenceobjectNoIdentifiers only, never payloads: tool, endpoint, status, request_id, client, mcp_version. Must serialize to 4096 bytes or fewer.
clientstringNoThe client that sent the report, e.g. claude-code/2.1.259 via redditapis-mcp@0.4.0. At most 120 characters.

Success Response

201 Created

{
  "id": "33333333-3333-4333-8333-333333333333",
  "status": "new",
  "created_at": "2026-09-04T10:14:22.318401+00:00"
}
FieldDescription
idThe report's server id. Pass it to Feedback Status later.
statusAlways new on creation. Moves to triaged, shipped or declined when the team acts.
created_atWhen the report was received.

Example

curl -X POST "https://api.redditapis.com/feedback" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "title": "GET /api/reddit/comments returns 502 when the post is deleted",
    "details": "- What happened: 502 upstream error instead of a 404\n- What the user said: user did not comment\n- Repro: GET /api/reddit/comments?permalink=/r/webdev/comments/abc123/x\n- Evidence: status 502, request id req_9f2",
    "area": "posts/comments",
    "evidence": { "endpoint": "/api/reddit/comments", "status": 502, "request_id": "req_9f2" },
    "client": "my-agent/1.0"
  }'
const response = await fetch("https://api.redditapis.com/feedback", {
  method: "POST",
  headers: { Authorization: "Bearer TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify({
    type: "missing_capability",
    title: "No endpoint returns a subreddit's flair list",
    details: "- What happened: the user asked for the flairs of r/webdev\n- What the user said: \"can you list the post flairs?\"\n- Repro: n/a\n- Evidence: no matching endpoint in openapi.json",
    area: "listings",
  }),
});
const { id, status } = await response.json();
import requests

response = requests.post(
    "https://api.redditapis.com/feedback",
    headers={"Authorization": "Bearer TOKEN"},
    json={
        "type": "idea",
        "title": "Let /api/reddit/search accept several subreddits at once",
        "details": "- What happened: the user searched 6 subreddits one call each\n- What the user said: \"this is slow\"\n- Repro: 6x GET /api/reddit/search?subreddit=...\n- Evidence: n/a",
        "area": "search",
    },
)
report = response.json()  # {"id": ..., "status": "new", "created_at": ...}

Errors

StatusMeaning
400{ "error": "invalid_request", "field": "...", "message": "..." }. The body was not a JSON object, or the named field is missing, the wrong type, or over its limit.
401Missing or invalid Bearer token
429Rate limit exceeded (more than 10 reports per minute on one key)
500Unexpected server error
502The feedback service is temporarily unavailable; retry in a moment

Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.

On this page