IMDb Keyword Search API

核心功能是调用IMDb关键词搜索接口，支持搜索影视、人物、剧集等多类内容，可自定义语言地区、结果数量、内容分类。适用于娱乐研究、影视内容发现等场景。输入需必填搜索词searchTerm，可选语言地区等参数，需JUST_ONE_API_TOKEN授权。输出含匹配结果、元数据等，先返回摘要再输出原始JSON，错误时返回后端信息

justoneapi

热度 31.95

最近更新 2026-05-11 17:46:13

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add justoneapi-imdb-main-search-query

Metadata

name: IMDb Keyword Search API
description: Call GET /api/imdb/main-search-query/v1 for IMDb Keyword Search through JustOneAPI with searchTerm.
author: JustOneAPI
homepage: https://api.justoneapi.com
metadata: {"openclaw":{"homepage":"https://api.justoneapi.com","primaryEnv":"JUST_ONE_API_TOKEN","requires":{"bins":["node"],"env":["JUST_ONE_API_TOKEN"]},"skillKey":"justoneapi_imdb_main_search_query"}}

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.