按分类或图片说明关键词获取 Yelp 商家照片
查看 Yelp 商家、评论与餐厅数据 的全部接口 →获取一家 Yelp 商家的照片元数据，支持使用商家别名、22 位商家 ID 或 Yelp 商家页面 URL。可通过 category 选择照片分类，也可通过 query 按图片说明中的关键词筛选。文档规定的默认值为 category=all、page=1、page_size=30；page 支持 1–1000，page_size 支持 1–100。请读取响应中的 categories，了解该商家实际可用的分类别名。 一份 page=1、page_size=3 的已记录响应中，count 为 14885，但本页实际只返回了 3 张照片，并非一次返回 14885 条记录。顶层分页字段包括 count、per_page、current_page、total_pages、next 和 previous。business 对象包含 id、alias、name 和 link；categories 中的记录包含 alias、name 和 photo_count。photos 中的每条记录包含 id、原始尺寸图片链接 link、thumbnail_link、caption、width、height、uploaded_at、tags、like_count、uploaded_by 和 review_id。uploaded_by 对象包含 id、name、link、location、photo_link、review_count、friend_count、photo_count、elite_year、is_elite 和 is_elite_all_star。在这份响应中出现这些字段，并不保证其他商家或其他页面中的每个字段都有值。 文档还提到了 videos 分类，但上述照片响应未核验视频专有字段。媒体链接只是资源引用，不代表已获准下载或转载。对于上传者信息，请仅保留获准用途所必需的内容。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/yelp/business-photos API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/business-photos?key=<API_KEY>&business=gary-danko-san-francisco&category=all&page=1&page_size=30'
查询结果
使用场景
- 根据响应中的分类别名和图片说明，为餐厅建立照片目录。
- 查看指定门店的食物、饮品、室内或菜单照片，但不将照片作为当前菜单内容的证明。
- 按页维护照片 ID、尺寸、缩略图和原始尺寸链接的元数据索引，并由应用记录获取时间。
- 在展示或转载图片前建立使用权限审核队列，同时尽量减少保留的上传者信息。
常见问题
获取照片时可以使用哪些商家标识？
必填参数 business 支持 Yelp 商家别名、22 位 Yelp 商家 ID 或 Yelp 商家页面 URL。例如，gary-danko-san-francisco 是文档中的商家别名。它定位的是一个商家条目，并非全城照片搜索。
如何选择照片分类或搜索图片说明？
请使用响应 categories 数组中的分类别名；不传 category 时默认为 all。文档示例包括 food、drink、interior、outside、menu 和 videos，但不同商家实际可用的分类可能不同。可选参数 query 用于匹配图片说明中的关键词，不用于搜索商家名称。
为什么 count 可能远大于 photos 数组的长度？
响应将分页元数据与当前页记录分开提供。一份 page_size=3 的已记录响应返回了 3 张照片，而 count 为 14885。不要把 count 当作当前 photos 数组的长度，也不要据此认为已经获取了全部记录。
page 和 page_size 支持哪些取值？
page 为 1–1000 的整数，默认值为 1；page_size 为 1–100 的整数，默认值为 30。请根据响应中的分页元数据判断可用页面，不要假定每一页都会达到指定条数。
照片和视频的响应字段都经过核验了吗？
已记录的响应核验了照片记录、商家标识、分类记录和分页元数据。照片字段涵盖原始尺寸及缩略图链接、图片说明、尺寸、上传时间、标签、点赞数、上传者信息和关联评论标识。文档虽然提到了视频，但视频专有响应字段尚未经过核验。
可以直接转载原始尺寸图片或上传者信息吗？
图片链接不授予下载、展示或转载权限。使用图片前请确认适用的授权，并仅保留获准用途所需的公开上传者信息。