IMDb APIs - Title Critics Review Summary (V1)
Retrieve a summary of critical reviews for a specific title.
Typical use cases:
- Display Metacritic scores and a compilation of professional critic feedback.
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-critics-review-summary-query/v1?token=YOUR_API_KEY&id=VALUE"text
I want to use the "Title Critics Review Summary (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/imdb/title-critics-review-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-critics-review-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-critics-review-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-critics-review-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-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
// 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-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
// 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-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;Responses
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"
}
}
}
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.