IMDb APIs - Title 'Did You Know' Insights (V1)
Retrieve interesting 'Did You Know' facts and trivia for a title.
Typical use cases:
- Enhance user engagement with fun facts and behind-the-scenes trivia.
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-did-you-know-query/v1?token=YOUR_API_KEY&id=VALUE"text
I want to use the "Title 'Did You Know' Insights (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/imdb/title-did-you-know-query/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/imdb-apis/title-did-you-know-insights-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-did-you-know-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-did-you-know-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-did-you-know-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-did-you-know-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-did-you-know-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",
"titleText": {
"text": "Furiosa: A Mad Max Saga",
"isOriginalTitle": true
},
"originalTitleText": {
"text": "Furiosa: A Mad Max Saga",
"isOriginalTitle": true
},
"trivia": {
"edges": [
{
"node": {
"__typename": "TitleTrivia",
"id": "tr7375706",
"isSpoiler": false,
"interestScore": {
"__typename": "InterestScore",
"usersInterested": 1230,
"usersVoted": 1239
},
"text": {
"plainText": "George Miller said this film's script was already complete before Mad Max: Fury Road (2015) was filmed: \"In order to tell that story cohesively, we had to know everything that happened in the time before, so we wrote a story about Furiosa from the time she was taken as a child, as she refers to in Fury Road, until she became the Imperator Furiosa. That ended up as a full screenplay, with concept art and so on. And the actors, the designers, and all the crew got the screenplay of that before shooting Fury Road.\""
},
"category": {
"id": "uncategorized"
},
"relatedNames": null,
"trademark": null
}
}
]
},
"quotes": {
"edges": [
{
"node": {
"__typename": "TitleQuote",
"id": "qt7429439",
"isSpoiler": false,
"interestScore": {
"__typename": "InterestScore",
"usersInterested": 86,
"usersVoted": 88
},
"lines": [
{
"characters": [
{
"character": "Dementus",
"name": {
"id": "nm1165110"
}
}
],
"text": "You fabulous thing. You crawled out of a pitiless grave, deeper than hell. Only one thing that is going to do that for you. Not hope. Hate. No shame in hate. It's one of the greatest forces of nature.",
"stageDirection": null
}
]
}
}
]
},
"goofs": {
"edges": [
{
"node": {
"__typename": "Goof",
"id": "gf7568572",
"isSpoiler": false,
"interestScore": {
"__typename": "InterestScore",
"usersInterested": 82,
"usersVoted": 94
},
"text": {
"plainText": "Shooting a gas can with a bullet will not make it blow up, this is one of the most common Hollywood firearms mistakes. In order for the gas to ignite a spark would need to be made, nearly all bullets have a copper jacket and a lead core, neither of which makes a spark when hitting metal."
},
"category": {
"id": "factual_error",
"text": "Factual errors"
}
}
}
]
},
"crazyCredits": {
"edges": [
{
"node": {
"__typename": "CrazyCredit",
"id": "cz0157303",
"interestScore": {
"__typename": "InterestScore",
"usersInterested": 63,
"usersVoted": 63
},
"text": {
"plainText": "There is a brief shot of Nux's (from Mad Max: Fury Road (2015)) crow-shaped bobble head from his car wobbling after the credits end."
}
}
}
]
},
"soundtrack": {
"edges": [
{
"node": {
"__typename": "Track",
"id": "sn2848601",
"text": "Anderlecht Champion AKA Ole Ole We Are the Champions",
"comments": [
{
"plainText": "Written by Roland Verlooven and Jeanine Dee"
}
]
}
}
]
},
"triviaCount": {
"total": 155
},
"quotesCount": {
"total": 40
},
"goofsCount": {
"total": 12
}
}
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.