分页查询 Yelp 用户的公开好友
查看 Yelp 商家、评论与餐厅数据 的全部接口 →按页获取指定 Yelp 贡献者的公开好友列表。必填参数 user 支持 22 个字符的 Yelp 用户 ID 或 Yelp 个人主页链接。page 的取值范围为 1–1000，文档默认值为 1；page_size 的取值范围为 1–50，文档默认值为 20。sort_by 支持 newest、oldest、name、name_desc 和 recently_reviewed，文档默认值为 newest。 接口文档列出的好友信息包括所在地、精英（Elite）身份，以及点评数、照片数和好友数。该接口尚无已观测响应，提供的成功示例仅为空对象（{}）。这些内容属于文档描述的能力，并非已验证的 JSON 字段；确切字段名、列表外层结构、分页元数据及缺失值的处理方式均未确认。请将返回页面视为有限的好友关系快照，而不是完整的关系网络。好友列表与关注列表并不等同。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/user-friends API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/user-friends?key=<API_KEY>&user=CHV3OXUzMbMDZ5A07UGO5A'
查询结果
使用场景
- 应用户要求整理其公开好友清单，在快照中保留所选页码、每页条数和排序方式。
- 在经批准的研究中，将有限的好友快照与另行获取的关注列表进行比较，同时保持两种关系类型的区分。
- 使用 name 或 name_desc 构建按姓名字母顺序浏览好友的界面，不根据列表位置推断关系亲疏。
- 在范围有限且经批准的贡献者研究中，查看实际返回的文档所述点评数和照片数，不补充身份信息，也不据此建立联系名单。
常见问题
查询好友时，user 参数支持哪些输入？
可传入 22 个字符的 Yelp 用户 ID 或 Yelp 个人主页链接。user 为必填参数，用于指定要查询哪位用户的好友。
如何对好友列表进行分页？
page 的取值范围为 1–1000，page_size 的取值范围为 1–50。文档默认请求第 1 页、每页 20 位好友。这些请求范围不保证所有允许的页码都有数据，也不保证列表完整。
好友列表支持哪些排序选项？
sort_by 支持 newest、oldest、name、name_desc 和 recently_reviewed，文档默认值为 newest。需要按姓名字母顺序排列时，可使用 name 或 name_desc。
这个接口返回用户关注的账号吗？
文档将其定义为好友接口，而非关注接口。如需关注数据，应另行获取，不应将好友关系与关注关系视为同一种关系。
文档列出了哪些好友信息？JSON 字段经过验证了吗？
文档列有所在地、Elite 身份，以及点评数、照片数和好友数。该接口尚无已观测响应，提供的成功示例仅为 {}。确切字段名、分页元数据和缺失值的处理方式仍未验证。