← Back to Skills Marketplace
IMDb Box Office Summary API
by
justoneapi
· GitHub ↗
· v1.0.0
· MIT-0
58
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install justoneapi-imdb-title-box-office-summary
Description
Call GET /api/imdb/title-box-office-summary/v1 for IMDb Box Office Summary through JustOneAPI with id.
README (SKILL.md)
IMDb Box Office Summary
Use this focused JustOneAPI skill for box Office Summary in IMDb. It targets GET /api/imdb/title-box-office-summary/v1. Required non-token inputs are id. OpenAPI describes it as: Get IMDb title Box Office Summary data, including grosses and related performance indicators, for revenue tracking and title comparison.
Endpoint Scope
- Platform key:
imdb - Endpoint key:
title-box-office-summary - Platform family: IMDb
- Skill slug:
justoneapi-imdb-title-box-office-summary
| Operation | Version | Method | Path | OpenAPI summary |
|---|---|---|---|---|
titleBoxOfficeSummary |
v1 |
GET |
/api/imdb/title-box-office-summary/v1 |
Box Office Summary |
Inputs
| Parameter | In | Required by | Optional by | Type | Notes |
|---|---|---|---|---|---|
id |
query |
all | n/a | string |
The unique IMDb ID of the title (e.g., tt12037194) |
languageCountry |
query |
n/a | all | string |
Language and country preferences. Available Values: - en_US: English (US) - fr_CA: French (Canada) - fr_FR: French (France) - de_DE: German (Germany) - hi_IN: Hindi (India) - it_IT: Italian (Italy) - pt_BR: Portuguese (Brazil) - es_ES: Spanish (Spain) - es_US: Spanish (US) - es_MX: Spanish (Mexico) |
languageCountry enum |
values | n/a | n/a | n/a | de_DE, en_US, es_ES, es_MX, es_US, fr_CA, fr_FR, hi_IN, it_IT, pt_BR |
Request body: none documented; send parameters through path or query arguments.
Version Choice
Use titleBoxOfficeSummary for the documented v1 endpoint. There are no alternate versions grouped in this skill.
Run This Endpoint
Supported operation IDs in this skill: titleBoxOfficeSummary.
node {baseDir}/bin/run.mjs --operation "titleBoxOfficeSummary" --token "$JUST_ONE_API_TOKEN" --params-json '{"id":"\x3Cid>"}'
Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.
Environment
- Required:
JUST_ONE_API_TOKEN - Pass the token with
--token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs. - Get a token from Just One API Dashboard.
- Authentication details: Just One API Usage Guide.
Output Focus
- State the operation ID and endpoint path used, for example
titleBoxOfficeSummaryon/api/imdb/title-box-office-summary/v1. - Echo the required lookup scope (
id) before summarizing results. - Prioritize fields that support this endpoint purpose: Get IMDb title Box Office Summary data, including grosses and related performance indicators, for revenue tracking and title comparison.
- Return raw JSON only after the short, endpoint-specific summary.
- If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill appears to do exactly what it claims: call JustOneAPI's IMDb box-office endpoint. Before installing, confirm you trust JustOneAPI and are comfortable providing JUST_ONE_API_TOKEN (the script sends it as a query parameter to https://api.justoneapi.com, which can be logged by servers or proxies). Ensure you do not paste the token into chat or logs; prefer storing it in the agent's secret store. Note the run.mjs helper outputs raw JSON only (SKILL.md asks for a short summary before raw JSON), so the agent should format any human-friendly summary itself. If you need stronger token privacy, verify whether the API supports Authorization headers or more restricted tokens and rotate keys if you stop using the skill.
Capability Analysis
Type: OpenClaw Skill
Name: justoneapi-imdb-title-box-office-summary
Version: 1.0.0
The skill is a standard API wrapper for retrieving IMDb box office data via JustOneAPI. The implementation in bin/run.mjs uses safe parameter handling (URLSearchParams and encodeURIComponent) and limits network activity to the documented domain (api.justoneapi.com). SKILL.md contains appropriate security guidance, specifically instructing the agent not to leak the authentication token in logs or chat.
Capability Assessment
Purpose & Capability
Name, description, required binary (node), required env var (JUST_ONE_API_TOKEN), and included run.mjs all align with calling JustOneAPI's GET /api/imdb/title-box-office-summary/v1. There are no unrelated credentials, binaries, or endpoints.
Instruction Scope
SKILL.md instructions are narrowly scoped to gathering the 'id' and calling the helper. One minor mismatch: SKILL.md asks the agent to return a short endpoint-specific summary followed by raw JSON, but bin/run.mjs writes only the raw JSON to stdout — the agent will need to format the summary itself. SKILL.md correctly warns not to paste the token in chat.
Install Mechanism
No install spec (instruction-only) and the included script is a small Node helper — nothing is downloaded from external or untrusted sources and nothing will be written to disk beyond using the provided script.
Credentials
Only JUST_ONE_API_TOKEN is required, which is appropriate. One operational detail: the token is sent as a query parameter (params.token) rather than in an Authorization header; this is coherent with the manifest but has privacy implications because tokens in query strings can be logged by intermediaries or servers.
Persistence & Privilege
Skill does not request persistent presence (always: false), does not modify other skills or system configs, and has no elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install justoneapi-imdb-title-box-office-summary - After installation, invoke the skill by name or use
/justoneapi-imdb-title-box-office-summary - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial publish
Metadata
Frequently Asked Questions
What is IMDb Box Office Summary API?
Call GET /api/imdb/title-box-office-summary/v1 for IMDb Box Office Summary through JustOneAPI with id. It is an AI Agent Skill for Claude Code / OpenClaw, with 58 downloads so far.
How do I install IMDb Box Office Summary API?
Run "/install justoneapi-imdb-title-box-office-summary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is IMDb Box Office Summary API free?
Yes, IMDb Box Office Summary API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does IMDb Box Office Summary API support?
IMDb Box Office Summary API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created IMDb Box Office Summary API?
It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.0.
More Skills