IMDb APIs - Title User Reviews Summary (V1)
Retrieve a summary of user-submitted reviews for a specific title.
Typical use cases:
- Get average user ratings and a snapshot of audience sentiment.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | User's authentication token. |
id | query | string | Yes | The unique IMDb ID of the title (e.g., tt12037194). |
languageCountry | query | string | No | 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) |
Code Samples
💡 Environment Note
Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.
bash
# Tip: For Mainland China, replace https://api.justoneapi.com with 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
I want to use the "Title User Reviews Summary (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/imdb/title-user-reviews-summary-query/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/imdb-apis/title-user-reviews-summary-v1-en.json
Parameters:
- token (query): User's authentication token. (Required)
- id (query): The unique IMDb ID of the title (e.g., tt12037194). (Required)
- languageCountry (query): 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)
Return format: JSON
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
Please help me write a script in my preferred programming language to call this API and handle the response.python
# Tip: For Mainland China, replace https://api.justoneapi.com with 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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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;Responses
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
}
}
]
}
}
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.