Necesitas encontrar videos relevantes de manera programática rápidamente, filtrarlos y agregar enlaces a tu producto. Al final de esta guía, podrás buscar videos de Facebook por palabra clave, leer los campos que necesitas (video_id, video_url, title, author, thumbnail) e integrar los resultados en tu flujo de trabajo utilizando la API de Scraper de Facebook en Zyla API Hub.
Lo que puedes construir con esta API de búsqueda de medios
La API de Scraper de Facebook te permite buscar en Facebook medios y entidades relacionadas sin lidiar con cambios en el sitio, emulación de dispositivos o navegadores sin cabeza.
- Buscar Videos: encuentra videos de Facebook (incluyendo Reels) que coincidan con una palabra clave. Devuelve metadatos de video como IDs, URLs, título/descripción, objeto autor, miniatura y una cadena cruda de “tiempo y vistas”.
- Buscar Páginas: descubre Páginas de Facebook relevantes para tu tema para obtener fuentes de video más tarde.
- Buscar Eventos: localiza eventos por palabra clave. Útil para calendarios editoriales o planificación de contenido en torno a la cobertura mediática.
Los equipos lo utilizan para funciones de descubrimiento social, herramientas editoriales, tableros de curación de medios y tuberías de alerta que vigilan nuevos videos que coinciden con términos de marca o tema.
Zyla API Hub centraliza más de 10,000 APIs públicas bajo una clave, una cuenta y un modelo de suscripción + cuota. No gestionas flujos de autenticación únicos por proveedor; llamas a través de una puerta de enlace estable en zylalabs.com.
Comenzando en Zyla API Hub
Abre la página de la API de Scraper de Facebook en Zyla API Hub, haz clic en “Suscribirse” o “Iniciar prueba de 7 días” cuando esté disponible, y obtén tu clave API. La autenticación es un solo encabezado en cada solicitud:
- Authorization: Bearer YOUR_API_KEY
La facturación es suscripción + cuota (no pago por llamada). Para el primer uso, normalmente accederás a una prueba de 7 días o 50 solicitudes; consulta la página de la API para opciones de acceso y precios actuales. Puedes navegar por otras APIs de medios y redes en zylalabs.com con la misma clave.
Puntos finales que usarás para buscar videos
Buscar Videos
Recupera videos que coincidan con una consulta de búsqueda.
- Método: GET
- URL: https://zylalabs.com/api/11904/facebook-scraper-api/22641/search-videos
- Parámetro de consulta requerido:
- query: un término de búsqueda. Ejemplo: football
Ejemplo de cURL (copia y pega tal cual):
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"
La respuesta devuelve un array de resultados con objetos por video, incluyendo:
- type: "search_video"
- video_id: el ID del video
- video_url: URL canónica de Facebook (por ejemplo, un Reel)
- title y description
- author: objeto anidado con name, url, is_verified, id
- thumbnail: URL a una imagen de vista previa
- time_and_views_raw: texto crudo con tiempo de publicación y conteo de vistas
Buscar Páginas
Recupera Páginas de Facebook relevantes para un término de búsqueda. Puedes usar esto para prefiltrar fuentes antes de buscar videos, dependiendo de tu flujo de trabajo.
- Método: GET
- URL: https://zylalabs.com/api/11904/facebook-scraper-api/22640/search-pages
- Parámetro de consulta requerido:
- query: un término de búsqueda. Ejemplo: messi
Buscar Eventos
Encuentra eventos por palabra clave para planificar la cobertura mediática o calendarios editoriales.
- Método: GET
- URL: https://zylalabs.com/api/11904/facebook-scraper-api/22642/search-events
- Parámetro de consulta requerido:
- query: un término de búsqueda. Ejemplo: beer
La respuesta incluye resultados (con tipo "search_event", event_id, title, url) y puede incluir una cadena de cursor que puedes almacenar para continuar una búsqueda más tarde si es necesario.
Ejemplo en Python: buscar videos y seleccionar los campos que necesitas
Este ejemplo llama a Buscar Videos con query=football, extrae los campos esenciales y imprime una lista compacta lista para agregar a una interfaz de usuario o tubería. Reemplaza YOUR_API_KEY con tu clave.
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")
Consejos:
- Almacena video_id como una clave estable. La URL es buena para mostrar, pero el ID es lo que usarás para la deduplicación.
- time_and_views_raw es una cadena legible por humanos; si necesitas números, mantenlo tal cual o analiza con precaución.
- Registra y vuelve a intentar 429/5xx según tu enfoque estándar de retroceso. El hub es suscripción + cuota; mantente dentro de la asignación de solicitudes de tu plan.
Ejemplo oficial: llamando a otro punto final para detalles del perfil
La lista también incluye un punto final de búsqueda de perfil. Lo siguiente es un ejemplo oficial del mercado—útil si complementas los resultados de video con metadatos de perfil.
{"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":"…
Campos que probablemente usarás:
- profile.name, profile.profile_id, profile.url para identidad y vinculación
- profile.image y profile.cover_image para UI
- profile.verified para señalar confianza
Trabajando con respuestas: notas prácticas
- Tiempo y vistas: Buscar Videos devuelve un “time_and_views_raw” legible por humanos. Mantenlo como una etiqueta o analiza con precaución.
- Miniaturas: thumbnail es una URL de imagen directa; no enlaces agresivamente en UIs de alto tráfico sin un almacenamiento en caché/CDN adecuado.
- Paginación/cursos: las respuestas de Buscar Eventos pueden incluir una cadena de cursor. Persiste si planeas paginar o reanudar escaneos más tarde.
- Deduplicación: usa video_id como la clave principal en tu base de datos. Combina con author.id para limitar análisis.
- Cuotas: el hub funciona con suscripción + cuota, no pago por llamada. Inspecciona tu plan en la página de la API y monitorea el uso en tu panel de Zyla.
Flujos de trabajo de medios en el mundo real
- Descubrimiento de contenido para editores: ejecuta Buscar Videos en atletas, programas o temas nombrados cada hora. Almacena video_id, título, autor y time_and_views_raw para clasificación.
- Monitoreo de marca: consulta nombres de productos o campañas y envía video_url coincidentes a equipos de moderación o comunidad.
- Obtención de canales: usa Buscar Páginas para encontrar fuentes de video probables, luego enfoca el rastreo o la cobertura editorial en esas páginas.
- Curación impulsada por eventos: Busca Eventos para festivales o lanzamientos próximos y prepara tus listas de videos alrededor de los títulos de los eventos.
Llamada desde agentes de IA a través de MCP
Puedes llamar a cualquier API de Zyla desde clientes compatibles con MCP (como Claude Code, Cursor, Windsurf). Los agentes se comunican con el punto final MCP de Zyla en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY y luego invocan las herramientas de esta API por ruta. Consulta la referencia de MCP para detalles de integración. Mantén la misma clave de autorización bearer al invocar puntos finales y prefiere IDs estables (video_id) en la memoria del agente.
Referencia: puntos finales y parámetros requeridos
Buscar Videos
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22641/search-videos
- Params: query (string, requerido). Ejemplo de valor: football
Buscar Páginas
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22640/search-pages
- Params: query (string, requerido). Ejemplo de valor: messi
Buscar Eventos
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22642/search-events
- Params: query (string, requerido). Ejemplo de valor: beer
Todas las solicitudes requieren: Authorization: Bearer YOUR_API_KEY
Explora otras listas de medios y redes en zylalabs.com. Tu misma clave API funciona en todo el hub.
FAQ
¿Cómo autentico las solicitudes?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud a la URL de la API de Zyla.
¿Qué campos puedo esperar en los resultados de búsqueda de videos?
Para cada elemento en los resultados: type, video_id, video_url, title, description, author{name, url, is_verified, id}, thumbnail y time_and_views_raw.
¿Hay paginación?
Las respuestas de Buscar Eventos incluyen una cadena de cursor que puedes almacenar para paginación o reanudar escaneos. Para otros puntos finales, maneja los arrays de resultados como se devuelven.
¿Cuáles son los límites de uso?
El uso es suscripción + cuota, no pago por llamada. El acceso por primera vez generalmente ofrece una prueba de 7 días o 50 solicitudes. Consulta la página de la API para opciones de acceso y precios actuales.
¿Puedo llamar a esto desde un agente de IA?
Sí. Usa el punto final MCP en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY desde un cliente compatible con MCP, luego invoca las herramientas de esta API con tu clave bearer.
¿Listo para implementar tu integración de búsqueda de medios? Comienza tu prueba en la API de Scraper de Facebook, obtén tu clave API e implementa la búsqueda de videos hoy.
Respuesta oficial de la 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":"…
Respuesta oficial de la 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":"…