← Back to Skills Marketplace
IMDb Keyword Search API
by
justoneapi
· GitHub ↗
· v1.0.0
· MIT-0
48
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install justoneapi-imdb-main-search-query
Description
Call GET /api/imdb/main-search-query/v1 for IMDb Keyword Search through JustOneAPI with searchTerm.
README (SKILL.md)
IMDb Keyword Search
Use this focused JustOneAPI skill for keyword Search in IMDb. It targets GET /api/imdb/main-search-query/v1. Required non-token inputs are searchTerm. OpenAPI describes it as: Get IMDb keyword Search data, including matched results, metadata, and ranking signals, for entity discovery and entertainment research.
Endpoint Scope
- Platform key:
imdb - Endpoint key:
main-search-query - Platform family: IMDb
- Skill slug:
justoneapi-imdb-main-search-query
| Operation | Version | Method | Path | OpenAPI summary |
|---|---|---|---|---|
mainSearchQuery |
v1 |
GET |
/api/imdb/main-search-query/v1 |
Keyword Search |
Inputs
| Parameter | In | Required by | Optional by | Type | Notes |
|---|---|---|---|---|---|
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 |
limit |
query |
n/a | all | integer |
Maximum number of results to return (1-300) |
searchTerm |
query |
all | n/a | string |
The term to search for (e.g., 'fire') |
type |
query |
n/a | all | string |
Category of results to include in search. Available Values: - Top: Top Results - Movies: Movies - Shows: TV Shows - People: People - Interests: Interests - Episodes: Episodes - Podcast: Podcasts - Video_games: Video Games |
type enum |
values | n/a | n/a | n/a | Episodes, Interests, Movies, People, Podcast, Shows, Top, Video_games |
Request body: none documented; send parameters through path or query arguments.
Version Choice
Use mainSearchQuery for the documented v1 endpoint. There are no alternate versions grouped in this skill.
Run This Endpoint
Supported operation IDs in this skill: mainSearchQuery.
node {baseDir}/bin/run.mjs --operation "mainSearchQuery" --token "$JUST_ONE_API_TOKEN" --params-json '{"searchTerm":"\x3CsearchTerm>"}'
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
mainSearchQueryon/api/imdb/main-search-query/v1. - Echo the required lookup scope (
searchTerm) before summarizing results. - Prioritize fields that support this endpoint purpose: Get IMDb keyword Search data, including matched results, metadata, and ranking signals, for entity discovery and entertainment research.
- 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: run a small Node script that calls JustOneAPI's IMDb search endpoint using your JUST_ONE_API_TOKEN. Before installing, confirm you trust the publisher (owner ID is present but the source repo is 'unknown') and that you want to share a JustOneAPI token with the skill. Note the token is sent as a query parameter (not an Authorization header), which can be logged by intermediaries — avoid pasting the token into chat and prefer using a least-privilege token from your JustOneAPI dashboard. If you need stronger privacy, verify the API supports header-based auth or contact the provider.
Capability Analysis
Type: OpenClaw Skill
Name: justoneapi-imdb-main-search-query
Version: 1.0.0
The skill bundle is a standard API wrapper for the JustOneAPI IMDb search service. The 'bin/run.mjs' script implements a clean, template-based approach to making HTTP GET requests to 'api.justoneapi.com' using the built-in fetch API. It includes appropriate parameter validation, URL encoding, and error handling, with no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (IMDb Keyword Search via JustOneAPI) match the included files and the single required env var (JUST_ONE_API_TOKEN). The required binary (node) is appropriate for running bin/run.mjs and no unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md limits runtime behavior to calling the documented GET endpoint and asks the agent to prompt for missing parameters. Implementation sends the API token as a query parameter (token) which is consistent with the manifest but can increase exposure in logs or caches — consider using an Authorization header if supported by the API.
Install Mechanism
There is no install spec (instruction-only behavior) and the packaged code is minimal (bin/run.mjs). Nothing is downloaded from external or untrusted URLs during install.
Credentials
The skill requires a single API credential JUST_ONE_API_TOKEN (declared as primary). That credential is necessary and proportional to the described API calls; no extra secrets or unrelated environment variables are requested.
Persistence & Privilege
The skill is not always-enabled and does not request persistent system-wide privileges or modify other skills' configuration. Autonomous invocation is allowed but is the platform default.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install justoneapi-imdb-main-search-query - After installation, invoke the skill by name or use
/justoneapi-imdb-main-search-query - 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 Keyword Search API?
Call GET /api/imdb/main-search-query/v1 for IMDb Keyword Search through JustOneAPI with searchTerm. It is an AI Agent Skill for Claude Code / OpenClaw, with 48 downloads so far.
How do I install IMDb Keyword Search API?
Run "/install justoneapi-imdb-main-search-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is IMDb Keyword Search API free?
Yes, IMDb Keyword Search API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does IMDb Keyword Search API support?
IMDb Keyword Search API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created IMDb Keyword Search API?
It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.0.
More Skills