IMDb Keyword Search API

Call GET /api/imdb/main-search-query/v1 for IMDb Keyword Search through JustOneAPI with searchTerm.

Security Scan

The skill's code, instructions, and requested credential align with its stated purpose (calling JustOneAPI's IMDb keyword search) and do not request unrelated privileges.

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.

Assessment

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.

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":"<searchTerm>"}'

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 mainSearchQuery on /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.