IMDb API - 标题影评人评价摘要 (V1)
获取指定作品的权威评测摘要。
典型应用场景：
- 展示Metacritic评分及专业媒体评测汇总。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户的鉴权令牌。 |
id | query | string | 是 | 该标题的唯一IMDb ID（例如：tt12037194）。 |
languageCountry | query | string | 否 | 语言与国家/地区偏好。 可用值： - en_US: 英语（美国）- fr_CA: 法语（加拿大）- fr_FR: 法语（法国）- de_DE: 德语（德国）- hi_IN: 印地语（印度）- it_IT: 意大利语（意大利）- pt_BR: 葡萄牙语（巴西）- es_ES: 西班牙语（西班牙）- es_US: 西班牙语（美国）- es_MX: 西班牙语（墨西哥） |
代码示例
💡 环境说明
默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。
bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/imdb/title-critics-review-summary-query/v1?token=YOUR_API_KEY&id=VALUE"text
我想使用 Just One API 提供的“标题影评人评价摘要 (V1)”接口。
接口地址: https://api.justoneapi.com/api/imdb/title-critics-review-summary-query/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/imdb-apis/title-critics-review-summary-v1-zh.json
请求参数说明:
- token (query): 用户的鉴权令牌。 (必填)
- id (query): 该标题的唯一IMDb ID（例如：tt12037194）。 (必填)
- languageCountry (query): 语言与国家/地区偏好。
可用值：
- `en_US`: 英语（美国）
- `fr_CA`: 法语（加拿大）
- `fr_FR`: 法语（法国）
- `de_DE`: 德语（德国）
- `hi_IN`: 印地语（印度）
- `it_IT`: 意大利语（意大利）
- `pt_BR`: 葡萄牙语（巴西）
- `es_ES`: 西班牙语（西班牙）
- `es_US`: 西班牙语（美国）
- `es_MX`: 西班牙语（墨西哥）
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/imdb/title-critics-review-summary-query/v1?token=YOUR_API_KEY&id=VALUE"
response = requests.get(url)
print(response.json())js
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/imdb/title-critics-review-summary-query/v1?token=YOUR_API_KEY&id=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/imdb/title-critics-review-summary-query/v1?token=YOUR_API_KEY&id=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/imdb/title-critics-review-summary-query/v1?token=YOUR_API_KEY&id=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/imdb/title-critics-review-summary-query/v1?token=YOUR_API_KEY&id=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果
json
{
"code": 0,
"data": {
"title": {
"id": "tt12037194",
"metacritic": {
"__typename": "Metacritic",
"metascore": {
"reviewCount": 64,
"score": 79
},
"url": "https://www.metacritic.com/movie/furiosa-a-mad-max-saga?ftag=MCD-06-10aaa1c",
"reviews": {
"edges": [
{
"node": {
"quote": {
"language": "en",
"value": "The chassis may look familiar but there is a very different engine driving Furiosa from that of Fury Road: it’s a rich, sprawling epic that only strengthens and deepens the Max-mythology. It shall ride eternal!"
},
"reviewer": "John Nugent",
"site": "Empire",
"score": 100,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "It’s hard to overstate how immaculately crafted Furiosa: A Mad Max Saga is, both as a prequel to Max Max: Fury Road and as a stand-alone story of how the Wasteland created a powerful character."
},
"reviewer": "Lex Briscuso",
"site": "IGN",
"score": 100,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "Director George Miller combines speed, grace and explosive violence, emulating Sam Peckinpah westerns and even, at times, the work of Charles Dickens – Furiosa is a bit like a young Artful Dodger, using her wits and courage to stay alive."
},
"reviewer": "Geoffrey Macnab",
"site": "The Independent",
"score": 100,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "Such an internally combusting prequel might seem like a strange lead-in to a movie that spit fire in every direction, but don’t you worry: George Miller still has what it takes to make it epic."
},
"reviewer": "David Ehrlich",
"site": "IndieWire",
"score": 91,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "So even as Furiosa is inevitably compared with Fury Road, both positively and negatively, put your trust in Miller’s weird, wild filmmaking."
},
"reviewer": "Rosie Knight",
"site": "Polygon",
"score": 85,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "Taylor-Joy also has to convey a tremendous amount of character arc in what is often a non-verbal performance (Miller recently revealed she only has 30 lines in the movie). No surprise, she absolutely kills it. But, miraculously, for a movie that doesn’t seem to leave the door open for further adventures, she’ll teasingly leave you wanting more."
},
"reviewer": "Gregory Ellwood",
"site": "The Playlist",
"score": 83,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "Is Furiosa as magnificent as Fury Road? No, though not because it’s the first Mad Max movie without Max, whose absence barely registers. At 140 minutes minus credits, it’s a touch unwieldy, while its lament for the inevitability of war and the emptiness of revenge feels hollow given the giddy excitement it stirs from just these things. But what can’t be disputed is that Miller, the Mad genius, has done it again, once more refusing to simply repeat himself and instead choosing to kick up dust rather than gather it as he forges a new path through the Wasteland in often spectacular fashion."
},
"reviewer": "Jamie Graham",
"site": "Total Film",
"score": 80,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "Taylor-Joy and Hemsworth are a great pairing and Taylor-Joy is an overwhelmingly convincing action heroine. She sells this sequel."
},
"reviewer": "Peter Bradshaw",
"site": "The Guardian",
"score": 80,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "So tip your the greasy, dusty, battered hat to George Miller, who is pulling off some kind of ridiculous feat by turning these grungy action movies into a grand saga."
},
"reviewer": "Steve Pond",
"site": "TheWrap",
"score": 75,
"url": null
}
},
{
"node": {
"quote": {
"language": "en",
"value": "Unfortunately, where the film falters is with its other star, the aforementioned Chris Hemsworth."
},
"reviewer": "Therese Lacson",
"site": "Collider",
"score": 70,
"url": null
}
}
]
}
},
"externalLinks": {
"__typename": "ExternalLinkConnection",
"total": 386,
"edges": [
{
"node": {
"label": "Roger Ebert [Robert Daniels]",
"url": "https://www.rogerebert.com/reviews/furiosa-movie-review-2024",
"externalLinkLanguages": null
}
},
{
"node": {
"label": "Sight & Sound [Beatrice Loayza]",
"url": "https://www.bfi.org.uk/sight-and-sound/reviews/furiosa-mad-max-saga-george-millers-ambitious-prequel-quickly-loses-steam",
"externalLinkLanguages": null
}
},
{
"node": {
"label": "150Film [Emre Cogulu]",
"url": "https://150film.blogspot.com/2024/05/furiosa-mad-max-saga.html",
"externalLinkLanguages": [
{
"__typename": "DisplayableLanguage",
"id": "tr",
"text": "Turkish"
}
]
}
},
{
"node": {
"label": "2 Film Critics [William Graebner, Dianne Bennett]",
"url": "https://www.2filmcritics.com/post/furiosa",
"externalLinkLanguages": null
}
}
],
"pageInfo": {
"__typename": "PageInfo",
"hasNextPage": true,
"hasPreviousPage": false,
"startCursor": "YW16bjEuaW1kYi5pdGVtLjIzNjU4Njcz",
"endCursor": "YW16bjEuaW1kYi5pdGVtLjIzOTAwMTI4"
}
}
}
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。