关于YouTube API Search.list无法获取指定国家受限视频的技术问询

1. 查询能力范围确认 #

YouTube Search API无法直接检索仅针对特定国家地域受限的视频。Search.list接口的设计逻辑是基于关键词、内容类型等条件，返回指定区域（通过regionCode参数，而非你提到的iq参数）可正常访问的公开内容，它不具备筛选"仅对目标区域开放/对其他区域受限"内容的能力，所以直接用Search.list无法得到你想要的结果。

2. 无关键词下的实现思路 #

若要获取特定国家（如印度、马来西亚）的地域受限视频，需通过组合API接口的方式实现，步骤如下：

• 第一步：获取目标国家的视频池
  调用Video.list接口，使用chart=mostPopular参数搭配regionCode（如IN对应印度、MY对应马来西亚），批量获取该区域的热门视频ID，无需指定关键词。
• 第二步：校验视频的地域限制属性
  对每个获取到的视频ID，再次调用Video.list接口，指定part=contentDetails，获取contentDetails.regionRestriction字段：
  • 若该字段存在，且allowed数组仅包含目标国家代码，说明此视频仅对该国家开放（即其他地域受限）；
  • 若blocked数组包含绝大多数国家，仅排除目标国家，也可判定为目标国家专属的受限视频。

示例请求（校验单视频地域限制）：

GET https://www.googleapis.com/youtube/v3/videos?part=contentDetails&id=VIDEO_ID&key=YOUR_API_KEY

注意：这种方式会产生较多API调用，需确保操作在你的API配额范围内。

内容的提问来源于stack exchange，提问作者Babak Kamali