IMDb Get Title Box Office Summary
8.73 credits/call
ae_imdb_get_title_box_office_summary
根据IMDb作品ID查询票房摘要,重点提供可用的首周末票房金额及周末起始日期,并可包含预算、本土累计票房和全球累计票房。必填id为tt开头的IMDb作品ID,不是电影名称;可先通过影片名称搜索取得IMDb ID。languageCountry用于选择语言与地区偏好,不是票房市场筛选。不同作品的数据可能不完整;首周末、本土累计和全球累计不能混为同一口径。
8.73 credits/call
Pricing
8.73 credits/call
| Condition | Charge |
|---|---|
| Each call | 8.73 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
id | string | Yes | 必填的IMDb作品ID,格式为tt后接数字,例如tt0111161。填写作品ID,不要填写作品名称。 | — |
languageCountry | enum (en_US | fr_CA | fr_FR | de_DE | hi_IN | it_IT | pt_BR | es_ES | es_US | es_MX) | No | 返回文本的语言与国家/地区偏好,默认值为en_US。只能使用允许值:en_US、fr_CA、fr_FR、de_DE、hi_IN、it_IT、pt_BR、es_ES、es_US、es_MX。此参数不用于筛选票房市场。 | en_US |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_imdb_get_title_box_office_summary' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"id": "tt0111161",
"languageCountry": "en_US"
}
}'Response exampleresponse.json
{
"code": 0,
"data": {
"title": {
"__typename": "Title",
"budget": {
"totalBudget": {
"__typename": "Money",
"amount": 25000000,
"currency": "USD"
}
},
"domesticGross": {
"__typename": "BoxOfficeGross",
"total": {
"__typename": "Money",
"amount": 28767189,
"currency": "USD"
}
},
"id": "tt0111161",
"openingWeekendGrosses": {
"total": 1
},
"originalTitleText": {
"isOriginalTitle": true,
"text": "The Shawshank Redemption"
}
}
},
"recordTime": "2026-11-17T02:03:25.916593089"
}This example shows part of the response. Copied content is valid JSON.

