IMDb API - 标题用户评价摘要 (V1)
获取特定标题下用户提交的评论摘要。
典型使用场景:
- 获取平均用户评分及受众情绪概览。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
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-user-reviews-summary-query/v1?token=YOUR_API_KEY&id=VALUE"text
我想使用 Just One API 提供的“标题用户评价摘要 (V1)”接口。
接口地址: https://api.justoneapi.com/api/imdb/title-user-reviews-summary-query/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/imdb-apis/title-user-reviews-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-user-reviews-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-user-reviews-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-user-reviews-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-user-reviews-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-user-reviews-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",
"canRate": {
"isRatable": true
},
"ratingsSummary": {
"aggregateRating": 7.5
},
"featuredReviews": {
"edges": [
{
"node": {
"__typename": "Review",
"id": "rw9804442",
"title": {
"id": "tt12037194"
},
"author": {
"id": "ur176771436",
"nickName": "jethro-17881"
},
"authorRating": 7,
"helpfulness": {
"__typename": "ReviewHelpfulness",
"upVotes": 752,
"downVotes": 188,
"score": 0.7732311540684124
},
"summary": {
"originalText": "Do you have it in you to make it epic?"
},
"text": {
"originalText": {
"plainText": "George Miller... \"Why yes, yes I do. Well sort of anyway...\"\n\nI really really wanted to love Furiosa but in the end I didn't, I liked it but didn't love it. Big big shoes to fill, I completely love Fury Road - a perfect action film in every way, so I was prepared to have this film fall in its shadow. Which it did. Furiosa is fun but its sadly no FR.\n\nThe good news: You want action? There is action, loads of it. Like any good Mad Max story it holds true to its promise to entertain the masses with spectacle. Glorious. We get the hot rods, big wheels, diggers, bikes of all shapes and sizes, as well as flying contraptions, weaponry galore and no holding back on the violence. Explosions, bodies flying, witness me etc. Plenty. It can be brutal and nasty but true to form and true to Mad Max. What more do you want?\n\nCasting is good, perhaps a few too many characters leaving each of them to have not quite enough to do especially with Immortan Joe's followers. Anja Taylor Joy is good as Furiosa and Hemsworth seems to really be enjoying himself. Dementus is a great villain, a sort of love child of Immortan Joe and The Humungus; the presence, the wee speeches, his villainy is fun. And he gets to be very Aussie no need to hide that accent. I also liked a younger and much cleverer Immortan Joe; in this film he's not the core bad guy and without the need to get his 5 wives back as a motivator making him crazy we get to see him as the warlord he is. Smart and patient and in control.\n\nAnd there's world building! Which was very cool. We got to see more of the Wasteland and get hints of how it ticks and what made it so.\n\nThe bad news: Visually Furiosa is a bit of a mixed bag; sometimes we get stuff worthy of its predecessor and other times we get stuff that is... less so. The colour is much more pale than the richness of FR and the cinematography is no where near the standards. Occasionally the CGI lets the film down just a bit. In Fury Road you got the impression that it was almost all practical effects even if it wasn't. In Furiosa there are sequences where I went... 'eww, yikes' as the standards of the film dropped. Only a few moments but be prepared.\n\nThe music is often absent or very lacking. The sweeping epics of Fury Road are almost gone instead we get much more background stuff or even sadly largely silent action sequences. This leads to a lack of tension, nothing edge of your seat here.\n\nThe writing and edit isn't great. The characters lack spark and bits feel missing. Miller is trying to tell a story but seems unsure of how to write characters in which one can invest. Furiosa has more ambition in its story telling and I think its execution is lacking. The core story solid but it seems a bit empty on the screen. The film jumps at times skipping over character development worthy of exploration.\n\nIn the edit i really really missed the fast cuts of Fury where Miller really built his scenes through tight production and cuts and edits where everything builds beautifully and leads to a great conclusions. Miller did this scene after scene in FR whereas in Furiosa its really lacking. Means theres not as much tension, not as many 'that was close' nor 'that was amazing' moments.\n\nOverall I did like it. Furiosa is a good Mad Max film but its no Fury Road. I'd be surprised if the film is recognized at Oscar time, where Fury Road won 6 Furiosa might get a nomination or two in the technical but no nominations for Directing or Best Picture.\n\nBy my deeds I honour him...\n\nBy my wallet I honour George Miller, Witness Furiosa. Its worth your time and money but not more than that."
}
},
"language": "en-US",
"submissionDate": "2024-05-23",
"spoiler": false
}
},
{
"node": {
"__typename": "Review",
"id": "rw9809656",
"title": {
"id": "tt12037194"
},
"author": {
"id": "ur154674572",
"nickName": "im-aire"
},
"authorRating": 6,
"helpfulness": {
"__typename": "ReviewHelpfulness",
"upVotes": 214,
"downVotes": 138,
"score": 0.5560506727909814
},
"summary": {
"originalText": "Mediocre, George Miller."
},
"text": {
"originalText": {
"plainText": "I had hopes for more action and crazy stunts. Less CGI and a more solid story.\n\nInstead I got bored, there was 10x more dialog.\n\nThe story on how Furiosa escaped was full of holes (a cult desperate for young healthy woman completely looking past her for years on end??).\n\nDementus was a glorified comedian and someone you could not take seriously. They couldn't even use the same voice effects for Immortan Joe as the 1st movie so he sounded like a small boy.\n\nThe 30 day war was a 10 second nothing.\n\nIt's a good movie but no way contends with the action scenes and stunts from fury road. It missed that action movie, edge of your seat vibe.\n\nI witnessed it and It did not ride through the gates of Valhalla shiny and chrome."
}
},
"language": "en-US",
"submissionDate": "2024-05-26",
"spoiler": false
}
},
{
"node": {
"__typename": "Review",
"id": "rw9850274",
"title": {
"id": "tt12037194"
},
"author": {
"id": "ur101292405",
"nickName": "an1h0ny"
},
"authorRating": 6,
"helpfulness": {
"__typename": "ReviewHelpfulness",
"upVotes": 135,
"downVotes": 69,
"score": 0.5943859660471962
},
"summary": {
"originalText": "Conflicted About This Movie"
},
"text": {
"originalText": {
"plainText": "Let me start off by saying this, if you enjoyed the last movie, you'll probably get a good time out of this one. That being said, it's night and day when you compare the two. I'm a huge fan of the last one, the spectacle and action make it one of the best films of all time imo, and it's clear they tried to recreate that with this movie, but for me it falls flat. Most, if not all, action sequences are all CGI, it's good CGI, but you can absolutely tell it's CG. There are lots of times in the movie where it straight up just looks out of a video game. I get where this comes from, the shots they go for are definitely a bit more ambitious, but it's lacking the chunky and gritty realism of the last film. The action can seem floaty and overly ragdolly at times because of this. Regardless, this isn't my biggest complaint with the movie, my biggest is the story. There are times when things just happen for no good reason at all, in an effort to avoid spoilers, I won't list them, but they are painstakingly obvious. For example, an integral character gets killed and it seems to be of zero consequence to one of the characters, even though the movie spends some time trying this half baked romance. I also just couldn't get into Anya Taylor-Joy as furiousa, maybe it's just a me thing, but she just doesn't really fit the gritty role she's meant to play. Chis Hemsworth is a standout performance though, although I do think, again, the writing for his character is a bit garbage. Regardless, this is a fun movie, lots of cool action shots, and pretty good if you have no preconceptions and expectations stemming from the last movie."
}
},
"language": "en-US",
"submissionDate": "2024-06-16",
"spoiler": false
}
},
{
"node": {
"__typename": "Review",
"id": "rw9803529",
"title": {
"id": "tt12037194"
},
"author": {
"id": "ur14955172",
"nickName": "johannes-stal"
},
"authorRating": 6,
"helpfulness": {
"__typename": "ReviewHelpfulness",
"upVotes": 704,
"downVotes": 411,
"score": 0.6026674040401013
},
"summary": {
"originalText": "MEDIOCRE!"
},
"text": {
"originalText": {
"plainText": "Max Mad fan here, I would rate previous movies: Mad Max around a 6, Road Warrior 8 Thunder Dome 7 Fury Road 9 and speaking of Fury Road....\n\nThis is unfortunately a pale comparison to Fury Road. The look is off everything from camerawork to editing to the costumes to vehicles to action scenes. Loads of bad CGI replaces the high octane realistic crazy stunts and motor mayhem from fury road. It all looks shot in a studio with fake everything. Big drop in quality and a sense of realism.\n\nIt's sad to see that Miller has settled for the studio instead of real vehicles in real environments with neck breaking stunts. Both clothes and vehicles just looks very designed now as well instead of a somewhat believable mishmash of what can be found in the wastelands. It's also a-lot cleaner in every way, vehicles look shiny and newly made. It just feels more censored and less naked and rough.\n\nThe story surprises nobody and is pretty much exactly what you expect. Void from a lot of the epic action scenes you might have to expect after fury road. You get some decent action but Fury Road is the gold standard here and this is not even close. Look and feels more like a cookie cutter action movie set in the Mad Max universe. Had I have to guess without knowing it I would never have guessed that Miller directed this. The world building is cool though and you get more of the cool world of Mad Max so that is a big plus.\n\nActors do a decent to a good job all around.\n\nImmortan Joe is not impressed.\n\nMEDIOCRE!!!"
}
},
"language": "en-US",
"submissionDate": "2024-05-22",
"spoiler": false
}
},
{
"node": {
"__typename": "Review",
"id": "rw10375719",
"title": {
"id": "tt12037194"
},
"author": {
"id": "ur184559303",
"nickName": "TalahaseesLittleBrother"
},
"authorRating": 9,
"helpfulness": {
"__typename": "ReviewHelpfulness",
"upVotes": 61,
"downVotes": 21,
"score": 0.640011292490288
},
"summary": {
"originalText": "Well, you wanted more story..."
},
"text": {
"originalText": {
"plainText": "Furiosa: A Mad Max Saga is a breathtaking technical triumph and a worthy evolution in George Miller's iconic franchise, delivering an epic origin story that stands proudly alongside Mad Max: Fury Road as a masterpiece of cinematic craftsmanship.\n\nAt the heart of this saga's success are the extraordinary dual performances by Anya Taylor-Joy and Alyla Browne as Furiosa, a casting triumph that elevates the film to legendary status. Alyla Browne, as the young Furiosa, delivers a breakout performance of astonishing maturity and intensity. Her wide-eyed innocence gradually hardens into unyielding determination, capturing the character's traumatic origins with raw emotional depth and fearless physicality that feels utterly authentic in this brutal world. Browne's commanding presence anchors the film's early chapters, making the young warrior's journey profoundly compelling and setting an impeccably high bar.\n\nThen, in a seamless transition that showcases the film's technical brilliance, Anya Taylor-Joy takes the reins and delivers one of the most riveting action-hero performances in recent cinema. With minimal dialogue, Taylor-Joy conveys volumes through her piercing gaze, coiled physicality, and ferocious energy-embodying Furiosa's evolution into the iconic imperator with magnetic charisma and unrelenting fury. Her commitment is total, blending vulnerability with unstoppable resolve in a tour de force that rivals Charlize Theron's legendary turn while carving out its own fierce identity. Together, Browne and Taylor-Joy create a singular, unforgettable Furiosa whose arc spans years and feels seamlessly lived-in.\n\nMiller continues to push the boundaries of action filmmaking with unparalleled technical excellence. The production design by Colin Gibson is nothing short of magnificent, expanding the Wasteland into a richly detailed, grotesque, and immersive universe filled with over-the-top characters and ingeniously crafted vehicles that feel authentically lived-in and functional.\n\nSimon Duggan's cinematography captures the vast, unforgiving landscapes with stunning clarity and dynamic energy, while the exquisite color palette-vibrant yet desolate-creates a visually superb experience that draws you deep into this apocalyptic world.\n\nThe editing by Margaret Sixel and Eliot Knapman masterfully weaves an episodic, years-spanning narrative into a cohesive saga, building tension across epic set pieces with precision and rhythm.\n\nTom Holkenborg's pulsating score complements the on-screen chaos perfectly, providing a powerful orchestral drive that enhances every thunderous moment without ever overpowering the visuals.\n\nEven the judicious integration of visual effects heightens the scale and intensity of the action sequences, delivering epic spectacle on a grand opera level while maintaining the series' signature physicality and kinetic force.\n\nFuriosa is unequivocally a Mad Max movie through and through-complete with a fleeting appearance by Max himself-and its bold differences from Fury Road only enrich the shared universe. This is remarkable movie art: ambitious, innovative, and executed with flawless technical prowess, anchored by two phenomenal performances that will be celebrated for years to come. George Miller has once again proven why he's a visionary director, and I can't wait for more journeys into this extraordinary apocalypse. Highly recommended-see it on the biggest screen possible!"
}
},
"language": "en-US",
"submissionDate": "2025-03-13",
"spoiler": false
}
}
]
}
}
}
}💡 提示:为简化展示,列表类数据样例仅保留 1-2 条记录,实际返回条数以接口响应为准。
