get_reddit_thread

get_reddit_thread MCP tool: fetch a single Reddit thread by ID, with GEO signals, scraped content and all in-app draft replies. Use it to poll enrichment status.

Updated 2026-04-26

get_reddit_thread

get_reddit_thread returns a single Reddit thread by ID, with the same shape as a list_reddit_threads row plus the full list of in-app draft replies. Its main role is to poll enrichment status after calling enrich_reddit_thread: status transitions through NEW → ENRICHING → ENRICHED (or DELETED if Bright Data detects the post was removed on Reddit).

When to use

Use it when your agent has just called enrich_reddit_thread and needs to wait for the scrape to land before reasoning on the post body and top comments. A simple polling loop with a 30-second backoff covers the typical 1 to 3 minute enrichment window. Also useful when an existing thread ID is shared across systems (Slack thread, internal ticket) and you want a fresh snapshot without a list call.

Input

Field Type Description
projectId string (CUID) Project the thread belongs to.
redditPostId string (CUID) Thread to fetch.

Response

{ found: true, thread } on success, { found: false, error } if the thread does not exist or belongs to another project. The thread payload mirrors list_reddit_threads rows; it carries the full replies array (most recent first), not just the latest.

{
  "found": true,
  "thread": {
    "id": "clxred001",
    "url": "https://reddit.com/r/SEO/comments/abc123",
    "canonicalPath": "/r/seo/comments/abc123",
    "subreddit": "seo",
    "title": "How are you tracking AI visibility in 2026?",
    "status": "ENRICHING",
    "statusUpdatedAt": null,
    "score": 18.4,
    "signals": { "citationCount": 4, "webSearchCount": 7, "totalSignals": 11, "llmCount": 3, "promptCount": 5 },
    "content": {
      "postDate": null,
      "numUpvotes": null,
      "numComments": null,
      "postBody": null,
      "topComments": null,
      "isDeletedOnReddit": false
    },
    "enriched": false,
    "enrichedAt": null,
    "replies": [],
    "createdAt": "2026-04-09T18:00:00.000Z",
    "updatedAt": "2026-04-26T11:00:00.000Z"
  }
}

When the scrape completes, the same call returns status: "ENRICHED", populated content fields and the generated replies[0].

{
  "found": false,
  "error": "Reddit thread not found or does not belong to this project"
}

Tips and patterns

  • Poll with a 30-second interval and a 5-minute hard timeout. Real enrichments land in 1 to 3 minutes; a longer wait usually means Bright Data is rate-limited or the post is dead.
  • Treat status: "DELETED" as terminal — do not re-trigger enrichment, the post is gone on Reddit.
  • The replies array can hold multiple drafts when the in-app user regenerated with different tones (helpful, casual, technical). Pick whichever fits your output, or read all and synthesise.
  • For batch polling, prefer list_reddit_threads with filters.status: ["ENRICHING"] over many parallel get_reddit_thread calls.

Related tools