IMDb 'Did You Know' Insights API (V1)
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Get IMDb title 'Did You Know' Insights data, including trivia, for editorial research and title insight enrichment.
Parameters
| Name | In | Type | Required | Default | 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 | en_US | 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
bash
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 "'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/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
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
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
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
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
<?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.