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

OperationVersionMethodPathOpenAPI summarymainSearchQuery``v1``GET``/api/imdb/main-search-query/v1Keyword Search

Inputs#

ParameterInRequired byOptional byTypeNoteslanguageCountry``queryn/aallstringLanguage 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 enumvaluesn/an/an/ade_DE, en_US, es_ES, es_MX, es_US, fr_CA, fr_FR, hi_IN, it_IT, pt_BR``limit``queryn/aallintegerMaximum number of results to return (1-300)searchTerm``queryalln/astringThe term to search for (e.g., 'fire')type``queryn/aallstringCategory 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 Gamestype enumvaluesn/an/an/aEpisodes, 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.

bash

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.