 |
网络与电视节目搜索-Tvmaze
专用API
【更新时间: 2024.04.26】
通过 Tvmaze 网络与电视节目搜索这项 API 服务，可以依据节目名称来搜索我们数据库中涵盖的所有相关节目，能够快速且精准地帮助用户找到他们所需的具体节目信息，为用户提供便捷的搜索体验。
4美元/月
去服务商官网采购>
|
- API详情
- 接口文档
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
产品介绍
什么是Tvmaze的网络与电视节目搜索?
服务详情
通过节目名称在我们的数据库中进行搜索，利用模糊匹配算法（容错度为2），即使存在轻微拼写错误也能准确找到节目。搜索结果将根据相关性排序，最匹配的节目位于列表顶部，并展示每个节目的详细信息。这个功能特别适合创建本地节目名称到TVmaze ID的映射，确保精确匹配。用户界面可以展示节目基本信息，让用户选择特定节目，从而让你的应用程序记录节目的ID或URL，便于后续请求直接定位到特定节目。
核心优势
核心功能
- 节目搜索，按节目名称搜索我们数据库中的所有节目。
- 单个节目搜索，它要么只返回一个结果，要么根本不返回任何结果。
- 按thetvdb 或 IMDB ID查找节目，如果您已经知道节目的 thetvdb 或 IMDB ID，则可以使用此端点在 TVmaze 上查找该节目。
- 人名搜索，使用与节目搜索相同的机制搜索我们数据库中的所有人。
应用场景
电视节目推荐应用
电视节目数据库
电视节目指南
电视节目集成到智能家居系统
什么是Tvmaze的网络与电视节目搜索？
由服务使用方的应用程序发起，以Restful风格为主、通过公网HTTP协议调用Tvmaze的网络与电视节目搜索，从而实现程序的自动化交互，提高服务效率。
使用指南
产品问答
?
有哪些付款方式可用？
付款由我们的合作伙伴Paddle处理，它接受所有主要信用卡和 Paypal。如果您的首选付款方式不可用，请告知我们，我们将努力将其纳入其中。
?
我可以按月付费吗？
由于每次付款都会产生付款处理费，因此我们鼓励您使用我们优惠的年度套餐。对于那些不喜欢按年订阅的人，这里提供按月套餐。请注意，每月套餐的价格更高，以弥补额外的交易费用。
?
什么是增值税？
在欧盟和英国进行的销售须遵守 VATMOSS 规则，该规则强制要求征收客户所在国家/地区的销售税。所有列出的价格均包含增值税。
?
我可以更改我的订阅吗？
您可以随时通过高级仪表板在不同的高级套餐之间切换。更改会自动按比例分配，这意味着您现有订阅的剩余价值将用于新订阅。
?
我如何取消我的订阅？
您可以随时通过高级仪表板取消订阅。取消订阅意味着不会再从您的帐户中扣除任何费用。只要您付费，您的高级功能就会保持活动状态，如仪表板上列出的那样。
?
有试用版吗？
是的！您可以完全免费试用 Premium 30 天。如果您在 30 天内取消试用，则不会产生任何费用。否则，我们会在试用期结束后自动将您转换为普通高级订阅。
关于我们
API接口列表
关键字搜索
1.1 简要描述
按节目名称搜索我们数据库中的所有节目
1.2 请求URL
https://api.tvmaze.com/search/shows?
1.3 请求方式
POST
1.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| q | String | 是 |
1.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|
1.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|
1.7 示例
请求参数{
"q": "girls"
}
返回参数
{}
错误码
{}
搜索单个节目
2.1 简要描述
搜索单个节目接口，它要么只返回一个结果，要么根本不返回任何结果。
2.2 请求URL
https://api.tvmaze.com/singlesearch/shows
2.3 请求方式
POST
2.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| q | String | 是 |
2.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|
2.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|
2.7 示例
请求参数{
"q": "girls"
}
返回参数
{}
错误码
{}
显示查找
3.1 简要描述
如果您已经知道节目的 thetvdb 或 IMDB ID，则可以使用此端点在 TVmaze 上查找该节目。
3.2 请求URL
https://api.tvmaze.com/lookup/shows
3.3 请求方式
POST
3.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|
3.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|---|---|---|
| thetvdb | String |
3.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|
3.7 示例
请求参数{}
返回参数
{
"thetvdb": " 81189"
}
错误码
{}
人物搜索
4.1 简要描述
使用与节目搜索相同的机制搜索我们数据库中的所有人。
4.2 请求URL
https://api.tvmaze.com/search/people
4.3 请求方式
POST
4.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|
4.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|---|---|---|
| q | String |
4.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|
4.7 示例
请求参数{}
返回参数
{
"q": "lauren"
}
错误码
{}
使用指南
依赖服务
产品问答
?
有哪些付款方式可用？
付款由我们的合作伙伴Paddle处理，它接受所有主要信用卡和 Paypal。如果您的首选付款方式不可用，请告知我们，我们将努力将其纳入其中。
?
我可以按月付费吗？
由于每次付款都会产生付款处理费，因此我们鼓励您使用我们优惠的年度套餐。对于那些不喜欢按年订阅的人，这里提供按月套餐。请注意，每月套餐的价格更高，以弥补额外的交易费用。
?
什么是增值税？
在欧盟和英国进行的销售须遵守 VATMOSS 规则，该规则强制要求征收客户所在国家/地区的销售税。所有列出的价格均包含增值税。
?
我可以更改我的订阅吗？
您可以随时通过高级仪表板在不同的高级套餐之间切换。更改会自动按比例分配，这意味着您现有订阅的剩余价值将用于新订阅。
?
我如何取消我的订阅？
您可以随时通过高级仪表板取消订阅。取消订阅意味着不会再从您的帐户中扣除任何费用。只要您付费，您的高级功能就会保持活动状态，如仪表板上列出的那样。
?
有试用版吗？
是的！您可以完全免费试用 Premium 30 天。如果您在 30 天内取消试用，则不会产生任何费用。否则，我们会在试用期结束后自动将您转换为普通高级订阅。
