← Back to Skills Marketplace
justoneapi

Reddit API

by justoneapi · GitHub ↗ · v1.0.6 · MIT-0
cross-platform ✓ Security Clean
167
Downloads
0
Stars
1
Active Installs
7
Versions
Install in OpenClaw
/install justoneapi-reddit
Description
Analyze Reddit workflows with JustOneAPI, including post Details, post Comments, and keyword Search.
README (SKILL.md)

Reddit

This skill wraps 3 Reddit operations exposed by JustOneAPI. It is strongest for post Details, post Comments, and keyword Search. Expect common inputs such as postId, after, cursor, keyword.

When To Use It

  • The user needs post Details or post Comments on Reddit.
  • The task lines up with keyword Search rather than a generic cross-platform workflow.
  • The user can provide identifiers or filters such as postId, after, cursor, keyword.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getRedditPostDetailV1: Post Details — Get Reddit post Details data, including author details, subreddit info, and engagement counts, for content analysis, moderation research, and monitoring
  • getRedditPostCommentsV1: Post Comments — Get Reddit post Comments data, including text, authors, and timestamps, for discussion analysis and moderation research
  • searchRedditV1: Keyword Search — Get Reddit keyword Search data, including titles, authors, and subreddit context, for topic discovery and monitoring

Request Pattern

  • 3 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are postId, after, cursor, keyword.
  • All operations in this skill are parameter-driven requests; none require a request body.

How To Work

  1. Read generated/operations.md before choosing an endpoint.
  2. Start with one of these operations when it matches the user's request: getRedditPostDetailV1, getRedditPostCommentsV1, searchRedditV1.
  3. Pick the smallest matching operation instead of guessing.
  4. Ask the user for any missing required parameter. Do not invent values.
  5. Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

Environment

  • Required: JUST_ONE_API_TOKEN
  • This skill uses JUST_ONE_API_TOKEN only for authenticated Just One API requests.
  • Keep JUST_ONE_API_TOKEN private. Do not paste it into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Rules

  • Start with a plain-language answer tied to the Reddit task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getRedditPostDetailV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as postId, after, cursor, echo those back so the scope is explicit.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill appears to do what it says: it makes authenticated GET requests to JustOneAPI's Reddit endpoints and only needs a JUST_ONE_API_TOKEN and node. Before installing, confirm you trust https://api.justoneapi.com and understand what the token grants. Note the token is sent as a URL query parameter (not an HTTP Authorization header), so it may be visible in logs or proxy traces—avoid pasting the token in chat or screenshots. If you require stronger token privacy, ask the maintainer to use an Authorization header or another safer transmission method.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description (Reddit via JustOneAPI) aligns with requirements: the skill requires node and a single JUST_ONE_API_TOKEN and exposes three Reddit-focused GET operations. Nothing requested appears unrelated to the stated purpose.
Instruction Scope
SKILL.md limits runtime actions to choosing an endpoint, asking the user for missing parameters, and invoking the bundled node CLI which issues GET requests to api.justoneapi.com. One notable detail: the token is sent as a query parameter (token=...), so the token may appear in server logs, intermediate proxies, or request histories; SKILL.md does warn to keep the token private. Error handling prints backend payloads which could echo returned data.
Install Mechanism
No install spec or external downloads. The skill is instruction-only with a small included Node script (bin/run.mjs). No installers, archives, or external URLs are fetched during install.
Credentials
Only JUST_ONE_API_TOKEN is required and is proportional to the API calls the skill makes. Caveat: the implementation places the token in the URL query string, which is less private than an Authorization header because it can be logged by servers or proxies.
Persistence & Privilege
The skill is not always-enabled, does not request elevated platform privileges, and does not modify other skills or system settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-reddit
  3. After installation, invoke the skill by name or use /justoneapi-reddit
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- Operation names updated for clarity: now use getRedditPostDetailV1, getRedditPostCommentsV1, and searchRedditV1. - Documentation, including SKILL.md and generated/operations.md, has been revised to reflect the new operation IDs. - No changes to input/output parameters or core functionality.
v1.0.5
- Updated the "Authentication details" and usage link under the Environment section for more accurate reference, including UTM parameters. - No changes to endpoint operations, usage workflow, or parameters.
v1.0.4
- Updated the Just One API dashboard sign-up link in the environment section for improved onboarding. - No logic or feature changes; documentation only.
v1.0.3
- Clarified environment usage to specify that `JUST_ONE_API_TOKEN` is used only for authenticated Just One API requests. - No functional changes to operations or workflow; documentation clarity improved.
v1.0.2
- Clarified that the `JUST_ONE_API_TOKEN` environment variable must be kept private and not shared in chat messages, screenshots, or logs. - No other functional or interface changes.
v1.0.1
- Added steps for acquiring an API token and links to the Just One API Dashboard and usage guide in the Environment section. - No changes to core functionality or endpoints.
v1.0.0
init
Metadata
Slug justoneapi-reddit
Version 1.0.6
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 7
Frequently Asked Questions

What is Reddit API?

Analyze Reddit workflows with JustOneAPI, including post Details, post Comments, and keyword Search. It is an AI Agent Skill for Claude Code / OpenClaw, with 167 downloads so far.

How do I install Reddit API?

Run "/install justoneapi-reddit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Reddit API free?

Yes, Reddit API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Reddit API support?

Reddit API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Reddit API?

It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.6.

💬 Comments