Usage Guide

Copying Post JSON

The core feature of ReddJSON — copying Reddit post data as JSON.

Step-by-Step

1. Browse any Reddit page — www.reddit.com or old.reddit.com
2. Find the { } JSON button in any post's action bar (next to Share, Save, etc.)
3. Click the button — a green toast "JSON copied!" appears
4. Paste the JSON anywhere: VS Code, Postman, Python scripts, etc.

What Gets Copied

The copied JSON is the full Reddit API response, which includes:

• Post data — title, author, subreddit, score, URL, selftext, created_utc, and more
• Comments — all comments with nested replies, scores, authors, and timestamps
• Metadata — post type, flair, awards, gilded status, etc.

The JSON is pretty-printed with 2-space indentation for readability.

Using the Sidebar

Click the ReddJSON extension icon in your browser toolbar to open the sidebar panel.

Viewing Copy History

The sidebar shows your last 50 copied posts as cards. Each card displays:

• Post title (clickable — opens the original Reddit post)
• Subreddit badge (e.g., r/javascript)
• Relative timestamp (e.g., "2 hours ago")
• Action buttons: Copy, View, Delete

Searching History

Use the search bar at the top of the sidebar to filter your history. You can search by:

• Post title
• Subreddit name
• Post ID

Search is debounced for smooth performance — results update as you type.

Re-Copying JSON

Click the "Copy" button on any history card to re-copy that post's full JSON to your clipboard. No need to revisit the Reddit post.

Viewing JSON

Click the "View" button to open a full-screen modal with the JSON displayed in a dark, syntax-highlighted code block. The modal includes:

• Formatted JSON with syntax highlighting
• Copy button to copy the JSON from the modal
• Backdrop blur effect
• Press Escape to close

Exporting History

Click the "Export" button to download your entire copy history as a timestamped .json file. The export includes all stored entries with their full JSON data.

Clearing History

Click "Clear All" to remove all history entries. A confirmation dialog prevents accidental deletion.

AI Post Generator

ReddJSON can generate LinkedIn posts from Reddit content using AI.

Setting Up AI Providers

1. Open the ReddJSON sidebar
2. Go to Settings
3. Choose your AI provider: OpenRouter or Groq
4. Enter your API key for the selected provider
5. Save settings

Generating a LinkedIn Post

1. Copy a Reddit post's JSON (click the JSON button on any post)
2. Open the ReddJSON sidebar
3. Find the copied post in your history
4. Click the "Generate LinkedIn Post" button
5. The AI generates a professional LinkedIn post based on the Reddit content
6. Copy the generated post and use it on LinkedIn

Keyboard Shortcuts

Shortcut	Action	Context
Ctrl+F / Cmd+F	Focus search input	Sidebar popup
Escape	Close any open modal	Sidebar popup

Toast Notifications

ReddJSON shows floating toast notifications for various events:

Type	Appearance	When Shown
Success	Green pill with checkmark	JSON copied successfully
Error	Red pill with X icon	Network error, private sub, rate limit
Info	Orange pill with info icon	Focus tab warning, loading states

Toasts auto-dismiss after 2 seconds and appear near the clicked button.

How It Works Under the Hood

The Reddit .json Endpoint

Every Reddit URL supports appending .json to get raw data:

https://www.reddit.com/r/javascript/comments/abc123/post_title/.json

The response is an array of two "Listing" objects:

[
  {
    "kind": "Listing",
    "data": {
      "children": [{
        "kind": "t3",
        "data": {
          "subreddit": "javascript",
          "title": "Post Title",
          "author": "username",
          "score": 42,
          "selftext": "Post body...",
          "created_utc": 1710000000
        }
      }]
    }
  },
  {
    "kind": "Listing",
    "data": {
      "children": [/* comments */]
    }
  }
]

Architecture

ReddJSON uses a clean separation of concerns:

• Content Script (content.js) — Injects buttons into Reddit pages, handles clicks, shows toasts, observes DOM changes
• Background Worker (background.js) — Fetches Reddit JSON API, manages storage operations
• Sidebar (sidebar.html/js/css) — History viewer, search, AI post generation, settings
• Storage (chrome.storage.local) — Persists history entries and settings

Troubleshooting

Buttons Not Appearing

Issue	Solution
No buttons on any posts	Open DevTools Console (F12) and check for [ReddJSON] logs
Reddit UI changed	Selectors may need updating — report on GitHub
Extension not loading	Check chrome://extensions and ensure extension is enabled
Conflicting extensions	Disable other Reddit extensions temporarily
SPA navigation issue	Try hard refresh (Ctrl+Shift+R)

JSON Not Copying

Issue	Solution
"Focus this tab" error	Click on the Reddit tab first, then click the JSON button
Network error	Check your internet connection
Private subreddit	Extension shows error toast — this is expected behavior
Rate limited	Wait a moment and try again
Very large JSON	May take longer — button shows spinner while loading

Contributing

Want to improve ReddJSON? Contributions are welcome!

1. Fork the repository
2. Create a feature branch: git checkout -b feature/awesome-thing
3. Make your changes
4. Test on both www.reddit.com and old.reddit.com
5. Commit: git commit -m 'Add awesome thing'
6. Push: git push origin feature/awesome-thing
7. Open a Pull Request