Reddit Thread Fetcher

💬 Fetch Reddit thread data using the public JSON API - zero friction, no authentication required! Perfect for social media monitoring and content research.

---

📺 What It Extracts

• Thread Metadata: ID, title, author, subreddit, score, upvotes, downvotes
• Comment Data: All comments with author, body, score, and timestamps
• Thread Structure: Nested comment replies and hierarchies
• Statistics: Total comment count and engagement metrics

---

🚀 Key Features

Feature	Description
🔓 Public API	Uses Reddit's public JSON API (append .json to URL)
🚫 No Authentication	Zero friction - no API keys required
📊 Complete Threads	Fetches all comments and nested replies
⚡ Fast Performance	Direct API access for quick data retrieval
🔄 Flexible Parsing	Handles various Reddit thread formats
📈 Structured Output	Clean JSON format with thread hierarchy

---

📥 Input

Required

• threadUrl (string): The Reddit thread URL
  • Example: "https://www.reddit.com/r/programming/comments/abc123/title/"
  • Supports any Reddit thread URL format

---

📤 Output

Returns comprehensive thread data:

Thread Metadata

{
  "thread": {
    "id": "abc123",
    "title": "Thread Title",
    "author": "username",
    "subreddit": "programming",
    "score": 150,
    "upvotes": 200,
    "downvotes": 50,
    "created": 1704067200,
    "createdDate": "2024-01-01T00:00:00.000Z",
    "url": "https://www.reddit.com/r/programming/comments/abc123/title/",
    "permalink": "/r/programming/comments/abc123/title/",
    "numComments": 45,
    "selftext": "Thread text content..."
  }
}

Comments Array

{
  "comments": [
    {
      "id": "def456",
      "author": "commenter",
      "body": "Comment text...",
      "score": 10,
      "created": 1704067300,
      "createdDate": "2024-01-01T00:01:40.000Z",
      "permalink": "/r/programming/comments/abc123/title/def456/",
      "replies": [
        {
          "id": "ghi789",
          "author": "replier",
          "body": "Reply text...",
          "score": 5
        }
      ]
    }
  ],
  "totalComments": 45
}

---

💡 Use Cases

• ✅ Social Media Monitoring - Track discussions and trends
• ✅ Content Research - Find relevant discussions and insights
• ✅ Sentiment Analysis - Analyze comment sentiment and engagement
• ✅ Community Insights - Understand community discussions
• ✅ Trend Tracking - Monitor popular topics and threads
• ✅ Data Collection - Collect data for research and analytics

---

⚙️ Technical Details

• API Source: Reddit's public JSON API (append .json to thread URL)
• No Authentication: Public API - no keys required
• Data Format: JSON responses from Reddit API
• Error Handling: Validates URLs and handles missing threads
• Performance: Fast API-based extraction without browser overhead

---

📝 Example Usage

Basic Thread Fetching

{
  "threadUrl": "https://www.reddit.com/r/programming/comments/abc123/title/"
}

Different Reddit Formats

{
  "threadUrl": "https://old.reddit.com/r/programming/comments/abc123/title/"
}

---

⚠️ Important Notes

• Uses Reddit's public JSON API - zero friction!
• The actor automatically appends .json to the thread URL
• Works with both www.reddit.com and old.reddit.com URLs
• Some threads may have deleted comments (shown as [deleted])
• The API is rate-limited but generally very permissive