您需要以编程方式快速找到相关视频,过滤它们,并将链接放入您的产品中。在本指南结束时,您将能够通过关键字搜索Facebook视频,读取所需的字段(video_id,video_url,title,author,thumbnail),并使用Zyla API Hub上的Facebook Scraper API将结果集成到您的工作流程中。
您可以使用此媒体搜索API构建的内容
Facebook Scraper API 让您在不处理网站更改、设备仿真或无头浏览器的情况下搜索Facebook上的媒体和相关实体。
- 搜索视频:查找与关键字匹配的Facebook视频(包括短视频)。返回视频元数据,如ID、URL、标题/描述、作者对象、缩略图和原始“时间和观看次数”字符串。
- 搜索页面:发现与您的主题相关的Facebook页面,以便稍后获取视频源。
- 搜索事件:按关键字定位事件。对于编辑日历或围绕媒体报道的内容规划非常有用。
团队使用它进行社交发现功能、编辑工具、媒体策划仪表板和监控新视频的警报管道,这些视频与品牌或主题术语匹配。
Zyla API Hub将超过10,000个公共API集中在一个密钥、一个帐户和一个订阅+配额模型下。您不需要为每个提供者管理一次性身份验证流程;您可以通过zylalabs.com的稳定网关进行调用。
在Zyla API Hub上开始
打开Zyla API Hub上的Facebook Scraper API页面,点击“订阅”或“开始7天试用”,获取您的API密钥。身份验证是在每个请求上的单个头:
- 授权:Bearer YOUR_API_KEY
计费是订阅+配额(而不是按调用付费)。首次使用时,您通常可以访问7天的试用或50个请求;请查看API页面以获取当前访问选项和定价。您可以使用相同的密钥在zylalabs.com浏览其他媒体和网络API。
您将用于视频搜索的端点
搜索视频
检索与搜索查询匹配的视频。
- 方法:GET
- URL:https://zylalabs.com/api/11904/facebook-scraper-api/22641/search-videos
- 所需查询参数:
- query:搜索词。例如:足球
示例cURL(按原样复制粘贴):
curl -s -X GET "https://zylalabs.com/api/11904/facebook-scraper-api/22610/profile-details-by-url?url=https%3A%2F%2Fwww.facebook.com%2Fzuck%2F" \
-H "Authorization: Bearer YOUR_API_KEY"
响应返回一个结果数组,其中包含每个视频对象,包括:
- type: "search_video"
- video_id: 视频的ID
- video_url: 规范的Facebook URL(例如,短视频)
- title和description
- author: 嵌套对象,包含name、url、is_verified、id
- thumbnail: 预览图像的URL
- time_and_views_raw: 包含发布时间和观看次数的原始文本
搜索页面
检索与搜索词相关的Facebook页面。您可以在搜索视频之前使用此功能预先过滤源,具体取决于您的工作流程。
- 方法:GET
- URL:https://zylalabs.com/api/11904/facebook-scraper-api/22640/search-pages
- 所需查询参数:
- query:搜索词。例如:梅西
搜索事件
按关键字查找事件,以便规划媒体覆盖或编辑日历。
- 方法:GET
- URL:https://zylalabs.com/api/11904/facebook-scraper-api/22642/search-events
- 所需查询参数:
- query:搜索词。例如:啤酒
响应包括结果(类型为"search_event",event_id,title,url),并可能包括一个光标字符串,您可以存储该字符串以便在需要时继续搜索。
Python示例:搜索视频并选择所需字段
此示例使用query=football调用搜索视频,提取必要字段,并打印出准备放入UI或管道的紧凑列表。将YOUR_API_KEY替换为您的密钥。
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/11904/facebook-scraper-api/22641/search-videos"
params = {"query": "football"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(BASE_URL, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data = resp.json()
videos = []
for item in data.get("results", []):
video = {
"id": item.get("video_id"),
"url": item.get("video_url"),
"title": item.get("title"),
"description": item.get("description"),
"author_name": (item.get("author") or {}).get("name"),
"author_url": (item.get("author") or {}).get("url"),
"verified": (item.get("author") or {}).get("is_verified"),
"thumbnail": item.get("thumbnail"),
"time_and_views": item.get("time_and_views_raw"),
}
videos.append(video)
for v in videos[:5]:
print(f"- {v['title']}\n {v['url']}\n by {v['author_name']} (verified={v['verified']})\n views/time: {v['time_and_views']}\n thumb: {v['thumbnail']}\n")
提示:
- 将video_id存储为稳定的键。URL在显示时很好,但ID是您用于去重的内容。
- time_and_views_raw是一个人类可读的字符串;如果您需要数字,请保持原样或谨慎解析。
- 根据您的标准回退方法记录并重试429/5xx。中心是订阅+配额;保持在您计划的请求配额内。
官方示例:调用另一个端点以获取个人资料详细信息
列表还包括一个个人资料查找端点。以下是来自市场的官方示例——如果您使用个人资料元数据增强视频结果,这将非常有用。
{"profile":{"name":"Mark Zuckerberg","profile_id":"4","url":"https://www.facebook.com/zuck","image":"https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_s480x480_tt6&_nc_cat=105&ccb=1-7&_nc_sid=1d2534&_nc_ohc=LjkvEg7sdw8Q7kNvwEaPsox&_nc_oc=AdmCdyxSpDASES67Y_gDG38HAgX4jHJmTVIhvvCWNAPvPyv-pT2MkqAPjlQhPbHwWrY8uW9gqGX2G_SqONA9jbku&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=IndkrZ-NXLMaL1RGOJUuzw&oh=00_Aft5Pz5CRJir2D9RSDB9DHeDE2DgVFClZFvg3B_3N3-Rdg&oe=69A18B0B","intro":"Bringing the world closer together.","cover_image":"https://scontent-atl3-3.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?_nc_cat=110&ccb=1-7&_nc_sid=2a1932&_nc_ohc=MK0GxxJ3MnAQ7kNvwGa91zk&_nc_oc=AdkYRmT5nQE8Wy7rtQIQVcsAFZpf2O-AfWgQayQistV8orDCmh3HHLcV1wyBGJ4MhxNmm_SjaJsm_Fhj0K4dUZng&_nc_zt=23&_nc_ht=scontent-atl3-3.xx&_nc_gid=IndkrZ-NXLMaL1RGOJUuzw&oh=00_AfvWwbUzfWNcxPpMjaQEicKtpNeAHrXk8D1zfpIjowyKEw&oe=69A17D22","gender":"MALE","about":{},"about_public":[{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yW/r/nS7-NxdkDDt.png","width":40},"text":"Profile · Public figure","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yi/r/Xcm_N7TYfz4.png","width":40},"text":"Founder and CEO at Meta","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yi/r/Xcm_N7TYfz4.png","width":40},"text":"Works at Biohub","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yW/r/nDxCDAeszOF.png","width":40},"text":"Studied Computer Science and Psychology at Harvard University","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yA/r/bStXkZOl3Ha.png","width":40},"text":"Lives in Palo Alto, California","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yh/r/k7egJAGHjmH.png","width":40},"text":"From Dobbs Ferry, New York","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yk/r/exk40A1bzjc.png","width":40},"text":"Married to Priscilla Chan","external_url":null}],"verified":true,"delegate_page_id":null,"reels_profile_id":"YXBwX2NvbGxlY3Rpb246cGZiaWQwUHlEa0Y2ZnV0NlFXdjhtS2NlNDR6dnp3OUJ5TnlXOVZXanNmM2hiWjJ1OXZ6cGVzQmh4NWdRd3RrUU1oajhHSGJoMjczN2hXcEMyMWJXWDRLTWw=","influencer_category":"Profile · Public figure","education":"…
您可能会使用的字段:
- profile.name,profile.profile_id,profile.url用于身份和链接
- profile.image和profile.cover_image用于UI
- profile.verified用于信任信号
处理响应:实用笔记
- 时间和观看次数:搜索视频返回一个人类可读的“time_and_views_raw”。将其保留为标签或谨慎解析。
- 缩略图:缩略图是直接的图像URL;在高流量的UI中,不要在没有适当缓存/CDN的情况下进行激进的热链接。
- 分页/光标:搜索事件响应可能包括一个光标字符串。如果您计划分页或稍后恢复扫描,请持久化它。
- 去重:在您的数据库中使用video_id作为主键。与author.id结合以限制分析。
- 配额:中心运行在订阅+配额上,而不是按调用付费。检查您的计划在API页面上的使用情况,并在您的Zyla仪表板中监控使用情况。
现实世界的媒体工作流程
- 编辑的内容发现:每小时对命名运动员、节目或主题运行搜索视频。存储video_id、title、author和time_and_views_raw以进行排名。
- 品牌监控:查询产品名称或活动,并将匹配的video_url推送到审核或社区团队。
- 频道来源:使用搜索页面查找可能的视频源,然后将下游爬虫或编辑覆盖集中在这些页面上。
- 事件驱动的策划:搜索事件以获取即将举行的节日或发布,并围绕事件标题准备您的视频观看列表。
通过MCP从AI代理调用
您可以从与MCP兼容的客户端(如Claude Code、Cursor、Windsurf)调用任何Zyla API。代理通过https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY与Zyla MCP端点进行通信,然后通过路径调用此API的工具。有关集成细节,请参阅MCP参考。调用端点时保持相同的授权承载密钥,并在代理内存中优先使用稳定的ID(video_id)。
参考:端点和所需参数
搜索视频
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22641/search-videos
- 参数:query(字符串,必需)。示例值:足球
搜索页面
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22640/search-pages
- 参数:query(字符串,必需)。示例值:梅西
搜索事件
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22642/search-events
- 参数:query(字符串,必需)。示例值:啤酒
所有请求都需要:授权:Bearer YOUR_API_KEY
在zylalabs.com上探索其他媒体和网络列表。您的相同API密钥在整个中心中有效。
常见问题
我如何验证请求?
在每个请求中发送授权:Bearer YOUR_API_KEY到Zyla API URL。
我可以依赖哪些字段在视频搜索结果中?
对于结果中的每个项目:type、video_id、video_url、title、description、author{name、url、is_verified、id}、thumbnail和time_and_views_raw。
是否有分页?
搜索事件响应包括一个光标字符串,您可以存储该字符串以进行分页或恢复扫描。对于其他端点,处理返回的结果数组。
使用限制是什么?
使用是订阅+配额,而不是按调用付费。首次访问通常提供7天的试用或50个请求。请查看API页面以获取当前访问选项和定价。
我可以从AI代理调用这个吗?
是的。从与MCP兼容的客户端使用https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY调用MCP端点,然后使用您的承载密钥调用此API的工具。
准备好发布您的媒体搜索集成了吗?在Facebook Scraper API上开始您的试用,获取您的API密钥,并立即实现视频搜索。
官方API响应
{"profile":{"name":"Mark Zuckerberg","profile_id":"4","url":"https://www.facebook.com/zuck","image":"https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_s480x480_tt6&_nc_cat=105&ccb=1-7&_nc_sid=1d2534&_nc_ohc=LjkvEg7sdw8Q7kNvwEaPsox&_nc_oc=AdmCdyxSpDASES67Y_gDG38HAgX4jHJmTVIhvvCWNAPvPyv-pT2MkqAPjlQhPbHwWrY8uW9gqGX2G_SqONA9jbku&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=IndkrZ-NXLMaL1RGOJUuzw&oh=00_Aft5Pz5CRJir2D9RSDB9DHeDE2DgVFClZFvg3B_3N3-Rdg&oe=69A18B0B","intro":"Bringing the world closer together.","cover_image":"https://scontent-atl3-3.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?_nc_cat=110&ccb=1-7&_nc_sid=2a1932&_nc_ohc=MK0GxxJ3MnAQ7kNvwGa91zk&_nc_oc=AdkYRmT5nQE8Wy7rtQIQVcsAFZpf2O-AfWgQayQistV8orDCmh3HHLcV1wyBGJ4MhxNmm_SjaJsm_Fhj0K4dUZng&_nc_zt=23&_nc_ht=scontent-atl3-3.xx&_nc_gid=IndkrZ-NXLMaL1RGOJUuzw&oh=00_AfvWwbUzfWNcxPpMjaQEicKtpNeAHrXk8D1zfpIjowyKEw&oe=69A17D22","gender":"MALE","about":{},"about_public":[{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yW/r/nS7-NxdkDDt.png","width":40},"text":"Profile · Public figure","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yi/r/Xcm_N7TYfz4.png","width":40},"text":"Founder and CEO at Meta","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yi/r/Xcm_N7TYfz4.png","width":40},"text":"Works at Biohub","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yW/r/nDxCDAeszOF.png","width":40},"text":"Studied Computer Science and Psychology at Harvard University","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yA/r/bStXkZOl3Ha.png","width":40},"text":"Lives in Palo Alto, California","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yh/r/k7egJAGHjmH.png","width":40},"text":"From Dobbs Ferry, New York","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yk/r/exk40A1bzjc.png","width":40},"text":"Married to Priscilla Chan","external_url":null}],"verified":true,"delegate_page_id":null,"reels_profile_id":"YXBwX2NvbGxlY3Rpb246cGZiaWQwUHlEa0Y2ZnV0NlFXdjhtS2NlNDR6dnp3OUJ5TnlXOVZXanNmM2hiWjJ1OXZ6cGVzQmh4NWdRd3RrUU1oajhHSGJoMjczN2hXcEMyMWJXWDRLTWw=","influencer_category":"Profile · Public figure","education":"…
官方API响应
{"profile":{"name":"Mark Zuckerberg","profile_id":"4","url":"https://www.facebook.com/zuck","image":"https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_s480x480_tt6&_nc_cat=105&ccb=1-7&_nc_sid=1d2534&_nc_ohc=LjkvEg7sdw8Q7kNvwEaPsox&_nc_oc=AdmCdyxSpDASES67Y_gDG38HAgX4jHJmTVIhvvCWNAPvPyv-pT2MkqAPjlQhPbHwWrY8uW9gqGX2G_SqONA9jbku&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&_nc_gid=IndkrZ-NXLMaL1RGOJUuzw&oh=00_Aft5Pz5CRJir2D9RSDB9DHeDE2DgVFClZFvg3B_3N3-Rdg&oe=69A18B0B","intro":"Bringing the world closer together.","cover_image":"https://scontent-atl3-3.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?_nc_cat=110&ccb=1-7&_nc_sid=2a1932&_nc_ohc=MK0GxxJ3MnAQ7kNvwGa91zk&_nc_oc=AdkYRmT5nQE8Wy7rtQIQVcsAFZpf2O-AfWgQayQistV8orDCmh3HHLcV1wyBGJ4MhxNmm_SjaJsm_Fhj0K4dUZng&_nc_zt=23&_nc_ht=scontent-atl3-3.xx&_nc_gid=IndkrZ-NXLMaL1RGOJUuzw&oh=00_AfvWwbUzfWNcxPpMjaQEicKtpNeAHrXk8D1zfpIjowyKEw&oe=69A17D22","gender":"MALE","about":{},"about_public":[{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yW/r/nS7-NxdkDDt.png","width":40},"text":"Profile · Public figure","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yi/r/Xcm_N7TYfz4.png","width":40},"text":"Founder and CEO at Meta","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yi/r/Xcm_N7TYfz4.png","width":40},"text":"Works at Biohub","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yW/r/nDxCDAeszOF.png","width":40},"text":"Studied Computer Science and Psychology at Harvard University","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yA/r/bStXkZOl3Ha.png","width":40},"text":"Lives in Palo Alto, California","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yh/r/k7egJAGHjmH.png","width":40},"text":"From Dobbs Ferry, New York","external_url":null},{"icon":{"height":40,"scale":2,"uri":"https://static.xx.fbcdn.net/rsrc.php/v4/yk/r/exk40A1bzjc.png","width":40},"text":"Married to Priscilla Chan","external_url":null}],"verified":true,"delegate_page_id":null,"reels_profile_id":"YXBwX2NvbGxlY3Rpb246cGZiaWQwUHlEa0Y2ZnV0NlFXdjhtS2NlNDR6dnp3OUJ5TnlXOVZXanNmM2hiWjJ1OXZ6cGVzQmh4NWdRd3RrUU1oajhHSGJoMjczN2hXcEMyMWJXWDRLTWw=","influencer_category":"Profile · Public figure","education":"…