TVmaze · 电视剧与演职员公共API
CloseTVmaze · 电视剧与演职员公共API
TVmaze官方免费公共API提供节目、剧集、排期和演职员JSON资料,支持名称搜索、ID读取与关联嵌入,示例无需密钥。数据受缓存与IP限流,CC BY-SA要求署名和相同方式共享。仅文档整理,未查询;Premium用户接口不含在此免费范围。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-431fa2d4636c302fe72ae761
- Card version
- 2
- Updated
- 2026-10-24T17:49:48.3340065+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
Add television information to your own website or app with a fast and clean TV API. Add schedules, show, episode, cast information, ...
Inputs
- /search/shows?q=名称或/search/people?q=名称;单结果/singlesearch/shows在同名多节目时匹配不确定。
- /shows/{id}、/episodes/{id}、/people/{id}等读详情,embed可添加支持的关联。
- /schedule可给ISO国家码和日期;web schedule对country省略/空串有不同含义;索引page按ID区间分页。
Outputs
- JSON节目/人物/剧集资料、关联列表和排期,遵循HATEOAS/HAL关联约定。
- image可为null,存在时给medium/original URL;本轮未下载或复用图片。
Invocation and authentication
{
"authentication": {
"kind": "none",
"notes": "\u672C\u6587\u4E3Afree public API\uFF0C\u76F4\u63A5HTTPS GET\u793A\u4F8B\u4E0D\u8981\u6C42\u8D26\u6237/key\uFF1BPremium\u6210\u5458user-level API\u53E6\u6709\u6587\u6863\u4E0E\u6761\u4EF6\uFF0C\u4E0D\u6DF7\u7528\u3002\u672C\u8F6E\u672A\u8C03\u7528\u3002"
},
"command": null,
"entry_url": "https://api.tvmaze.com",
"kind": "http_api",
"method": "GET",
"request_example": null,
"requirements": [
"HTTPS\u5BA2\u6237\u7AEF\uFF0C\u6309\u8282\u76EE/\u4EBA\u7269\u540D\u79F0\u6216TVmaze ID\u9009\u62E9\u516C\u5F00\u7AEF\u70B9\u3002",
"\u9075\u5B88\u7F72\u540D\u4E0EShareAlike\uFF1B\u5B8C\u6574\u7248\u6743\u3001\u56FE\u7247\u548C\u4E1A\u52A1\u9002\u914D\u6761\u4EF6\u9700\u6309\u5B9E\u9645\u7528\u9014\u6838\u3002",
"\u5904\u7406\u7F13\u5B58\u3001HTTP429\u4E0E\u7F3A\u5931/\u7A7A\u5B57\u6BB5\uFF1BUser-Agent\u5B98\u65B9\u5EFA\u8BAE\u4F46\u5E76\u975E\u5FC5\u586B\u8BA4\u8BC1\u3002"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "documented_free",
"notes": "\u5B98\u65B9\u660E\u786E\u516C\u5171REST API\u514D\u8D39\uFF1BPremium user-level API\u53CAEnterprise\u4E0D\u540C\u8BB8\u53EF/SLA\u53E6\u6709\u6761\u4EF6\uFF0C\u672A\u6838\u4EF7\u683C\u3002\u516C\u5171\u6570\u636E\u6309CC BY-SA\u987B\u7F72\u540D\u53CAShareAlike\u3002",
"source_url": "https://www.tvmaze.com/api"
}{
"location": "provider_server",
"notes": "\u5B9E\u9645\u8C03\u7528\u53D1\u9001\u8282\u76EE/\u4EBA\u7269\u67E5\u8BE2\u548CIP\u7B49\u7F51\u7EDC\u5143\u6570\u636E\uFF0C\u65E5\u5FD7/\u4FDD\u7559\u672A\u77E5\u3002\u63A5\u53E3\u63D0\u4F9B\u56FE\u7247\u94FE\u63A5\u548C\u7248\u6743\u653F\u7B56\uFF0C\u672A\u72EC\u7ACB\u786E\u8BA4\u6240\u6709\u5E95\u5C42\u56FE\u7247\u6743\u5229\uFF1B\u672C\u8F6E\u672A\u53D1\u9001\u7528\u6237\u8D44\u6599\u6216\u4E0B\u8F7D\u5185\u5BB9\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 常规输出缓存60分钟,节目索引和full schedule等可缓存24小时,不是实时保证。
- 官方列至少20次/10秒/IP,特殊情况可更严格并返回429;不是无限额度承诺。
- 公共API与Premium个人数据/Enterprise许可、SLA等分开,不推断免费获得所有服务。
- lookup按外部ID匹配可返回301或404;完整schedule至少数MB,不能将其当轻量查询。
Unknowns
- 实际响应、节目覆盖、时间表准确性和服务可用性未验证。
- 具体图片使用权、商业衍生作品许可适用及Enterprise/Premium价格未知。
- 未查询API、播放节目或运行能力测试。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T17:48:25.1570860\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://www.tvmaze.com/api"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": null,
"availability": "unknown",
"callability": "documentation_only",
"category": "development",
"data_handling": {
"location": "provider_server",
"notes": "\u5B9E\u9645\u8C03\u7528\u53D1\u9001\u8282\u76EE/\u4EBA\u7269\u67E5\u8BE2\u548CIP\u7B49\u7F51\u7EDC\u5143\u6570\u636E\uFF0C\u65E5\u5FD7/\u4FDD\u7559\u672A\u77E5\u3002\u63A5\u53E3\u63D0\u4F9B\u56FE\u7247\u94FE\u63A5\u548C\u7248\u6743\u653F\u7B56\uFF0C\u672A\u72EC\u7ACB\u786E\u8BA4\u6240\u6709\u5E95\u5C42\u56FE\u7247\u6743\u5229\uFF1B\u672C\u8F6E\u672A\u53D1\u9001\u7528\u6237\u8D44\u6599\u6216\u4E0B\u8F7D\u5185\u5BB9\u3002"
},
"description": "Add television information to your own website or app with a fast and clean TV API. Add schedules, show, episode, cast information, ...",
"inputs": [
"/search/shows?q=\u540D\u79F0\u6216/search/people?q=\u540D\u79F0\uFF1B\u5355\u7ED3\u679C/singlesearch/shows\u5728\u540C\u540D\u591A\u8282\u76EE\u65F6\u5339\u914D\u4E0D\u786E\u5B9A\u3002",
"/shows/{id}\u3001/episodes/{id}\u3001/people/{id}\u7B49\u8BFB\u8BE6\u60C5\uFF0Cembed\u53EF\u6DFB\u52A0\u652F\u6301\u7684\u5173\u8054\u3002",
"/schedule\u53EF\u7ED9ISO\u56FD\u5BB6\u7801\u548C\u65E5\u671F\uFF1Bweb schedule\u5BF9country\u7701\u7565/\u7A7A\u4E32\u6709\u4E0D\u540C\u542B\u4E49\uFF1B\u7D22\u5F15page\u6309ID\u533A\u95F4\u5206\u9875\u3002"
],
"invocation": {
"authentication": {
"kind": "none",
"notes": "\u672C\u6587\u4E3Afree public API\uFF0C\u76F4\u63A5HTTPS GET\u793A\u4F8B\u4E0D\u8981\u6C42\u8D26\u6237/key\uFF1BPremium\u6210\u5458user-level API\u53E6\u6709\u6587\u6863\u4E0E\u6761\u4EF6\uFF0C\u4E0D\u6DF7\u7528\u3002\u672C\u8F6E\u672A\u8C03\u7528\u3002"
},
"command": null,
"entry_url": "https://api.tvmaze.com",
"kind": "http_api",
"method": "GET",
"request_example": null,
"requirements": [
"HTTPS\u5BA2\u6237\u7AEF\uFF0C\u6309\u8282\u76EE/\u4EBA\u7269\u540D\u79F0\u6216TVmaze ID\u9009\u62E9\u516C\u5F00\u7AEF\u70B9\u3002",
"\u9075\u5B88\u7F72\u540D\u4E0EShareAlike\uFF1B\u5B8C\u6574\u7248\u6743\u3001\u56FE\u7247\u548C\u4E1A\u52A1\u9002\u914D\u6761\u4EF6\u9700\u6309\u5B9E\u9645\u7528\u9014\u6838\u3002",
"\u5904\u7406\u7F13\u5B58\u3001HTTP429\u4E0E\u7F3A\u5931/\u7A7A\u5B57\u6BB5\uFF1BUser-Agent\u5B98\u65B9\u5EFA\u8BAE\u4F46\u5E76\u975E\u5FC5\u586B\u8BA4\u8BC1\u3002"
]
},
"limitations": [
"\u5E38\u89C4\u8F93\u51FA\u7F13\u5B5860\u5206\u949F\uFF0C\u8282\u76EE\u7D22\u5F15\u548Cfull schedule\u7B49\u53EF\u7F13\u5B5824\u5C0F\u65F6\uFF0C\u4E0D\u662F\u5B9E\u65F6\u4FDD\u8BC1\u3002",
"\u5B98\u65B9\u5217\u81F3\u5C1120\u6B21/10\u79D2/IP\uFF0C\u7279\u6B8A\u60C5\u51B5\u53EF\u66F4\u4E25\u683C\u5E76\u8FD4\u56DE429\uFF1B\u4E0D\u662F\u65E0\u9650\u989D\u5EA6\u627F\u8BFA\u3002",
"\u516C\u5171API\u4E0EPremium\u4E2A\u4EBA\u6570\u636E/Enterprise\u8BB8\u53EF\u3001SLA\u7B49\u5206\u5F00\uFF0C\u4E0D\u63A8\u65AD\u514D\u8D39\u83B7\u5F97\u6240\u6709\u670D\u52A1\u3002",
"lookup\u6309\u5916\u90E8ID\u5339\u914D\u53EF\u8FD4\u56DE301\u6216404\uFF1B\u5B8C\u6574schedule\u81F3\u5C11\u6570MB\uFF0C\u4E0D\u80FD\u5C06\u5176\u5F53\u8F7B\u91CF\u67E5\u8BE2\u3002"
],
"outputs": [
"JSON\u8282\u76EE/\u4EBA\u7269/\u5267\u96C6\u8D44\u6599\u3001\u5173\u8054\u5217\u8868\u548C\u6392\u671F\uFF0C\u9075\u5FAAHATEOAS/HAL\u5173\u8054\u7EA6\u5B9A\u3002",
"image\u53EF\u4E3Anull\uFF0C\u5B58\u5728\u65F6\u7ED9medium/original URL\uFF1B\u672C\u8F6E\u672A\u4E0B\u8F7D\u6216\u590D\u7528\u56FE\u7247\u3002"
],
"pricing": {
"model": "documented_free",
"notes": "\u5B98\u65B9\u660E\u786E\u516C\u5171REST API\u514D\u8D39\uFF1BPremium user-level API\u53CAEnterprise\u4E0D\u540C\u8BB8\u53EF/SLA\u53E6\u6709\u6761\u4EF6\uFF0C\u672A\u6838\u4EF7\u683C\u3002\u516C\u5171\u6570\u636E\u6309CC BY-SA\u987B\u7F72\u540D\u53CAShareAlike\u3002",
"source_url": "https://www.tvmaze.com/api"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "public_record",
"checked_at": "2026-10-24T17:48:25.1570860\u002B00:00",
"title": "TV API | TVmaze - Add TV information to your website or app.",
"url": "https://www.tvmaze.com/api"
}
],
"summary": "TVmaze\u5B98\u65B9\u514D\u8D39\u516C\u5171API\u63D0\u4F9B\u8282\u76EE\u3001\u5267\u96C6\u3001\u6392\u671F\u548C\u6F14\u804C\u5458JSON\u8D44\u6599\uFF0C\u652F\u6301\u540D\u79F0\u641C\u7D22\u3001ID\u8BFB\u53D6\u4E0E\u5173\u8054\u5D4C\u5165\uFF0C\u793A\u4F8B\u65E0\u9700\u5BC6\u94A5\u3002\u6570\u636E\u53D7\u7F13\u5B58\u4E0EIP\u9650\u6D41\uFF0CCC BY-SA\u8981\u6C42\u7F72\u540D\u548C\u76F8\u540C\u65B9\u5F0F\u5171\u4EAB\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u67E5\u8BE2\uFF1BPremium\u7528\u6237\u63A5\u53E3\u4E0D\u542B\u5728\u6B64\u514D\u8D39\u8303\u56F4\u3002",
"tags": [
"TVmaze",
"\u7535\u89C6\u5267",
"\u6F14\u804C\u5458",
"\u5A92\u4F53\u5143\u6570\u636E",
"HTTP API",
"\u65E0\u9700\u5BC6\u94A5",
"CC BY-SA"
],
"terms_url": null,
"title": "TVmaze \u00B7 \u7535\u89C6\u5267\u4E0E\u6F14\u804C\u5458\u516C\u5171API",
"unknowns": [
"\u5B9E\u9645\u54CD\u5E94\u3001\u8282\u76EE\u8986\u76D6\u3001\u65F6\u95F4\u8868\u51C6\u786E\u6027\u548C\u670D\u52A1\u53EF\u7528\u6027\u672A\u9A8C\u8BC1\u3002",
"\u5177\u4F53\u56FE\u7247\u4F7F\u7528\u6743\u3001\u5546\u4E1A\u884D\u751F\u4F5C\u54C1\u8BB8\u53EF\u9002\u7528\u53CAEnterprise/Premium\u4EF7\u683C\u672A\u77E5\u3002",
"\u672A\u67E5\u8BE2API\u3001\u64AD\u653E\u8282\u76EE\u6216\u8FD0\u884C\u80FD\u529B\u6D4B\u8BD5\u3002"
],
"verification": {
"checked_at": "2026-10-24T17:48:25.1570860\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://www.tvmaze.com/api"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-431fa2d4636c302fe72ae761",
"version": 2,
"source_url": "https://www.tvmaze.com/api",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"url": "https://www.tvmaze.com/api",
"final_url": "https://www.tvmaze.com/api",
"status_code": 200,
"title": "TV API | TVmaze - Add TV information to your website or app.",
"description": "Add television information to your own website or app with a fast and clean TV API. Add schedules, show, episode, cast information, ...",
"checked_at": "2026-10-24T17:48:25.157086\u002B00:00",
"warnings": [
"\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
]
},
"created_at": "2026-10-24T17:48:27.8245178\u002B00:00",
"updated_at": "2026-10-24T17:49:48.3340065\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-431fa2d4636c302fe72ae761?version=2",
"page_url": "https://navonavo.com/capabilities/cap-431fa2d4636c302fe72ae761?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u5A92\u4F53\u5143\u6570\u636E\uFF5C\u514D\u5BC6\u94A5\u7535\u89C6\u5267\u4E0E\u6F14\u804C\u5458API",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-30abf3169e8542d176c76f22a84a45d5",
"source_url": "https://www.tvmaze.com/api",
"content_sha256": "697b7180721a82758b40158e4748364816419c3766d1600c9ca04780c1f699c1",
"decoded_bytes": 48593,
"content_type": "text/html",
"captured_at": "2026-10-24T17:48:25.1570860\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "697b7180721a82758b40158e4748364816419c3766d1600c9ca04780c1f699c1",
"text_utf8_bytes": 48593,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-431fa2d4636c302fe72ae761/materials/material-30abf3169e8542d176c76f22a84a45d5?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-1dcc40a7eb0f4035a3303c00681995db",
"reason": "\u4F9D\u636E\u672C\u6279TVmaze\u5B98\u65B9\u516C\u5171API\u6587\u6863\u6574\u7406\u5165\u53E3\u3001\u68C0\u7D22\u3001\u7F13\u5B58\u3001\u9650\u6D41\u4E0ECC BY-SA\uFF1B\u4E0D\u67E5\u8BE2\u8282\u76EE\u6216\u4E0B\u8F7D\u56FE\u7247\u3002",
"source_urls": [
"https://www.tvmaze.com/api"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-431fa2d4636c302fe72ae761",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-431fa2d4636c302fe72ae761?version=2",
"page_url": "https://navonavo.com/capabilities/cap-431fa2d4636c302fe72ae761?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}