← Back to Skills Marketplace
justoneapi

Instagram API

by justoneapi · GitHub ↗ · v1.0.8 · MIT-0
cross-platform ⚠ suspicious
199
Downloads
0
Stars
1
Active Installs
9
Versions
Install in OpenClaw
/install justoneapi-instagram
Description
Analyze Instagram workflows with JustOneAPI, including user Profile, post Details, and user Published Posts across 5 operations.
README (SKILL.md)

Instagram

This skill wraps 5 Instagram operations exposed by JustOneAPI. It is strongest for user Profile, post Details, user Published Posts, and reels Search. Expect common inputs such as paginationToken, username, code, endCursor, hashtag.

When To Use It

  • The user needs user Profile or post Details on Instagram.
  • The task lines up with user Published Posts rather than a generic cross-platform workflow.
  • The user can provide identifiers or filters such as paginationToken, username, code, endCursor.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getInstagramUserDetailV1: User Profile — Get Instagram user Profile data, including follower count, following count, and post count, for obtaining basic account metadata for influencer vetting, tracking follower growth and audience reach over time, and mapping user handles to specific profile stats
  • getInstagramPostDetailV1: Post Details — Get Instagram post Details data, including post caption, media content (images/videos), and publish time, for analyzing engagement metrics (likes/comments) for a specific post and archiving post content and media assets for content analysis
  • getInstagramUserPostsV1: User Published Posts — Get Instagram user Published Posts data, including post code, caption, and media type, for monitoring recent publishing activity of a specific user and building a historical record of content for auditing or analysis
  • searchReelsV1: Reels Search — Get Instagram reels Search data, including post ID, caption, and author profile, for tracking trends and viral content via specific keywords or hashtags and discovering high-engagement reels within a particular niche

Request Pattern

  • 5 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are paginationToken, username, code, endCursor, hashtag.
  • 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: getInstagramUserDetailV1, getInstagramPostDetailV1, getInstagramUserPostsV1, searchReelsV1.
  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 Instagram task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getInstagramUserDetailV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as paginationToken, username, code, 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 legitimately wraps JustOneAPI Instagram endpoints and needs JUST_ONE_API_TOKEN, so functionality is coherent. The main risk is secret exposure: the provided usage example passes your token on the command line and the script appends it to the URL query — both can leak the token to process listings, shell history, or logs. Before installing or using: (1) Prefer running the script in a secure/isolated environment (dedicated VM/container) if you must pass the token this way. (2) Consider modifying bin/run.mjs to read JUST_ONE_API_TOKEN from process.env (not a CLI arg) and send it in an Authorization header if the API supports it, to avoid exposing it in argv and URLs. (3) Use a least-privilege, short-lived token if possible and rotate it after testing. (4) Review JustOneAPI's privacy/logging policy (requests go to api.justoneapi.com) and confirm you trust the provider with the requested Instagram data. (5) If you are not comfortable modifying code, avoid passing long-lived secrets on the CLI and do not paste tokens into chat or screenshots.
Capability Analysis
Type: OpenClaw Skill Name: justoneapi-instagram Version: 1.0.8 The skill is a standard API wrapper for JustOneAPI's Instagram services, providing functionality to retrieve user profiles, post details, and search reels. The implementation in `bin/run.mjs` is a straightforward Node.js script that uses the built-in fetch API to communicate exclusively with the legitimate domain `api.justoneapi.com`. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description, required binary (node), and declared env var (JUST_ONE_API_TOKEN) match the included manifest and code. All endpoints are on api.justoneapi.com and correspond to Instagram profile/post/hashtag/reels operations described in the SKILL.md and generated OpenAPI artifacts.
Instruction Scope
The SKILL.md instructs calling the bundled Node script with: node bin/run.mjs --operation "..." --token "$JUST_ONE_API_TOKEN" --params-json '...'. Passing the secret via a CLI flag (and the script then inserts it as a query parameter named 'token') risks exposing the token in process listings, shell history, and proxy/server logs. Aside from that secret-handling issue, the instructions stay within the stated purpose and do not request unrelated files or credentials.
Install Mechanism
No remote install or downloads are performed; the skill is instruction/code-only and requires an existing 'node' binary. No external archives, package installs, or unusual install locations are used.
Credentials
Only one env var (JUST_ONE_API_TOKEN) is required, which is proportionate to the API integration. However, the implementation sends that token as a query parameter and the SKILL.md instructs passing it on the command line — both increase the chance of accidental exposure (process lists, shell history, server logs). The token request itself is otherwise justified by the skill's purpose.
Persistence & Privilege
The skill does not request persistent/always-on privileges and does not modify other skills or system configuration. Autonomous invocation is allowed (platform default) but not combined with other elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-instagram
  3. After installation, invoke the skill by name or use /justoneapi-instagram
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.8
- Operation IDs updated: now use getInstagramUserDetailV1, getInstagramPostDetailV1, getInstagramUserPostsV1 instead of previous names. - SKILL.md updated to reflect new operation IDs throughout usage guidance and representative operations. - Generated documentation (operations.json, operations.md) synced to match new operation naming. - No changes to core functionality or required environment variables.
v1.0.7
- Updated authentication details link in the Environment section for improved onboarding. - Adjusted URLs to include UTM parameters for referral tracking. - No functional changes to operations or usage.
v1.0.6
- Updated the Just One API Dashboard link to include UTM parameters for improved referral tracking. - No functional changes to skill logic or usage instructions.
v1.0.5
Version 1.0.5 - Updated SKILL.md to clarify token usage in the Environment section. - Added that `JUST_ONE_API_TOKEN` is used solely for authenticated Just One API requests.
v1.0.4
- Clarified that the `JUST_ONE_API_TOKEN` environment variable must be kept private and not shared in chat messages, screenshots, or logs. - No changes in endpoints, operations, or parameter usage. All descriptions and usage patterns remain the same.
v1.0.3
Version 1.0.3 - Updated SKILL.md with instructions on obtaining the required API token from the Just One API Dashboard. - Added documentation links for authentication and usage details to assist users.
v1.0.2
rename
v1.0.1
- Updated the skill name in documentation from "justoneapi_instagram" to "Instagram API" for improved clarity. - No changes to codebase, endpoints, or functional behavior—documentation only.
v1.0.0
justoneapi-instagram 1.0.0 - Initial release of the JustOneAPI Instagram integration skill. - Supports 5 key Instagram data operations: user Profile, post Details, user Published Posts, and reels Search. - Enables precise, parameter-driven Instagram queries using fields like `username`, `code`, and `hashtag`. - Provides a clear step-by-step usage guide and recommended output practices for API-backed answers.
Metadata
Slug justoneapi-instagram
Version 1.0.8
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 9
Frequently Asked Questions

What is Instagram API?

Analyze Instagram workflows with JustOneAPI, including user Profile, post Details, and user Published Posts across 5 operations. It is an AI Agent Skill for Claude Code / OpenClaw, with 199 downloads so far.

How do I install Instagram API?

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

Is Instagram API free?

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

Which platforms does Instagram API support?

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

Who created Instagram API?

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

💬 Comments