IMDb APIs - Title Release Expectation (V1)
Retrieve release expectation data for a specific title.
Typical use cases:
- Analyze audience anticipation for upcoming movie or TV show releases.
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) |
acceptCache | query | boolean | No | Whether to accept cached data. |
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-release-expectation-query/v1?token=YOUR_API_KEY&id=VALUE"text
I want to use the "Title Release Expectation (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/imdb/title-release-expectation-query/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/imdb-apis/title-release-expectation-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)
- acceptCache (query): Whether to accept cached data.
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-release-expectation-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-release-expectation-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-release-expectation-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-release-expectation-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-release-expectation-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": {
"__typename": "Title",
"id": "tt12037194",
"titleText": {
"text": "Furiosa: A Mad Max Saga",
"isOriginalTitle": true
},
"originalTitleText": {
"text": "Furiosa: A Mad Max Saga",
"isOriginalTitle": true
},
"releaseYear": {
"__typename": "YearRange",
"year": 2024,
"endYear": null
},
"releaseDate": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "US"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
},
"titleType": {
"__typename": "TitleType",
"id": "movie",
"text": "Movie",
"categories": [
{
"id": "movie",
"text": "Movie",
"value": "movie"
}
],
"canHaveEpisodes": false,
"isEpisode": false,
"isSeries": false,
"displayableProperty": {
"value": {
"plainText": ""
}
}
},
"primaryImage": {
"__typename": "Image",
"id": "rm645622785",
"url": "https://m.media-amazon.com/images/M/MV5BNTcwYWE1NTYtOWNiYy00NzY3LWIwY2MtNjJmZDkxNDNmOWE1XkEyXkFqcGc@._V1_.jpg",
"height": 4096,
"width": 2764
},
"productionStatus": {
"__typename": "ProductionStatusDetails",
"announcements": null,
"currentProductionStage": {
"id": "released",
"text": "Released"
},
"productionStatusHistory": [
{
"comment": null,
"date": "2020-10-13",
"status": {
"id": "pre_production",
"text": "Pre-production"
}
},
{
"comment": null,
"date": "2022-05-20",
"status": {
"id": "filming",
"text": "Filming"
}
},
{
"comment": null,
"date": "2022-10-12",
"status": {
"id": "post_production",
"text": "Post-production"
}
},
{
"comment": null,
"date": "2023-05-29",
"status": {
"id": "released",
"text": "Released"
}
},
{
"comment": null,
"date": "2023-05-29",
"status": {
"id": "post_production",
"text": "Post-production"
}
},
{
"comment": null,
"date": "2023-08-31",
"status": {
"id": "post_production",
"text": "Post-production"
}
},
{
"comment": null,
"date": "2023-12-17",
"status": {
"id": "post_production",
"text": "Post-production"
}
},
{
"comment": null,
"date": "2024-04-10",
"status": {
"id": "completed",
"text": "Completed"
}
},
{
"comment": {
"text": "Derived from earliest release of 2024-05-15 (FR)"
},
"date": "2024-05-15",
"status": {
"id": "released",
"text": "Released"
}
}
]
},
"episodes": null,
"wideReleaseDates": {
"edges": [
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "BE"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "CH"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "DK"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "FR"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "ID"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "KR"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "PH"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "SE"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "SG"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "TH"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 22,
"year": 2024,
"country": {
"id": "TW"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "AR"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "AU"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "AZ"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "BR"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "CL"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "DE"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "HR"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "HU"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "IL"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "IN"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "IT"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "KH"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "KW"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "KZ"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "LB"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "MK"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "MN"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "MX"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "MY"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "NL"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "PE"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "PT"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "RS"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "SK"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 23,
"year": 2024,
"country": {
"id": "UA"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "CA"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "EC"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "EE"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "ES"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "FI"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "GB"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "IE"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "IS"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "MM"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "NO"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "PL"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "RO"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "TR"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "US"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 24,
"year": 2024,
"country": {
"id": "ZA"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 31,
"year": 2024,
"country": {
"id": "JP"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 6,
"day": 7,
"year": 2024,
"country": {
"id": "CN"
},
"restriction": null,
"attributes": [],
"displayableProperty": {
"qualifiersInMarkdownList": null
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 8,
"day": 16,
"year": 2024,
"country": {
"id": "US"
},
"restriction": null,
"attributes": [
{
"id": "internet",
"text": "internet"
}
],
"displayableProperty": {
"qualifiersInMarkdownList": [
{
"expandedMarkdown": "internet"
}
]
}
}
}
]
},
"excludeWideReleaseDates": {
"edges": [
{
"node": {
"__typename": "ReleaseDate",
"month": 5,
"day": 15,
"year": 2024,
"country": {
"id": "FR"
},
"restriction": null,
"attributes": [
{
"id": "Cannes Film Festival",
"text": "Cannes Film Festival"
}
],
"displayableProperty": {
"qualifiersInMarkdownList": [
{
"expandedMarkdown": "Cannes Film Festival"
}
]
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 6,
"day": 25,
"year": 2024,
"country": {
"id": "US"
},
"restriction": null,
"attributes": [
{
"id": "PVOD",
"text": "PVOD"
}
],
"displayableProperty": {
"qualifiersInMarkdownList": [
{
"expandedMarkdown": "PVOD"
}
]
}
}
},
{
"node": {
"__typename": "ReleaseDate",
"month": 8,
"day": 13,
"year": 2024,
"country": {
"id": "US"
},
"restriction": null,
"attributes": [
{
"id": "DVD,4K UHD,Blu-ray",
"text": "DVD,4K UHD,Blu-ray"
}
],
"displayableProperty": {
"qualifiersInMarkdownList": [
{
"expandedMarkdown": "DVD,4K UHD,Blu-ray"
}
]
}
}
}
]
}
}
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.