Você precisa encontrar vídeos relevantes rapidamente, filtrá-los e inserir links em seu produto. Ao final deste guia, você será capaz de buscar vídeos do Facebook por palavra-chave, ler os campos que precisa (video_id, video_url, title, author, thumbnail) e integrar os resultados em seu fluxo de trabalho usando a API Facebook Scraper no Zyla API Hub.
O que você pode construir com esta API de busca de mídia
A API Facebook Scraper permite que você busque no Facebook por mídias e entidades relacionadas sem lidar com mudanças de site, emulação de dispositivos ou navegadores sem cabeça.
- Buscar Vídeos: encontre vídeos do Facebook (incluindo Reels) que correspondam a uma palavra-chave. Retorna metadados de vídeo como IDs, URLs, título/descrição, objeto autor, thumbnail e uma string bruta de “tempo e visualizações”.
- Buscar Páginas: descubra Páginas do Facebook relevantes para seu tópico para obter feeds de vídeo mais tarde.
- Buscar Eventos: localize eventos por palavra-chave. Útil para calendários editoriais ou planejamento de conteúdo em torno da cobertura da mídia.
Equipes usam isso para recursos de descoberta social, ferramentas editoriais, painéis de curadoria de mídia e pipelines de alerta que monitoram novos vídeos correspondentes a termos de marca ou tópico.
O Zyla API Hub centraliza mais de 10.000 APIs públicas sob uma chave, uma conta e um modelo de assinatura + cota. Você não gerencia fluxos de autenticação únicos por provedor; você chama através de um gateway estável em zylalabs.com.
Começando no Zyla API Hub
Abra a página da API Facebook Scraper no Zyla API Hub, clique em “Assinar” ou “Iniciar teste de 7 dias” quando disponível, e obtenha sua chave de API. A autenticação é um único cabeçalho em cada solicitação:
- Authorization: Bearer YOUR_API_KEY
A cobrança é por assinatura + cota (não por chamada). Para o primeiro uso, você normalmente terá acesso a um teste de 7 dias ou 50 solicitações; verifique a página da API para opções de acesso e preços atuais. Você pode navegar por outras APIs de mídia e redes sociais em zylalabs.com com a mesma chave.
Endpoints que você usará para busca de vídeos
Buscar Vídeos
Recupere vídeos que correspondam a uma consulta de busca.
- Método: GET
- URL: https://zylalabs.com/api/11904/facebook-scraper-api/22641/search-videos
- Parâmetro de consulta obrigatório:
- query: um termo de busca. Exemplo: futebol
Exemplo de cURL (copie e cole como está):
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"
A resposta retorna um array de resultados com objetos por vídeo, incluindo:
- type: "search_video"
- video_id: o ID do vídeo
- video_url: URL canônica do Facebook (por exemplo, um Reel)
- title e description
- author: objeto aninhado com nome, url, is_verified, id
- thumbnail: URL para uma imagem de pré-visualização
- time_and_views_raw: texto bruto com hora de publicação e contagem de visualizações
Buscar Páginas
Recupere Páginas do Facebook relevantes para um termo de busca. Você pode usar isso para pré-filtrar fontes antes de buscar vídeos, dependendo do seu fluxo de trabalho.
- Método: GET
- URL: https://zylalabs.com/api/11904/facebook-scraper-api/22640/search-pages
- Parâmetro de consulta obrigatório:
- query: um termo de busca. Exemplo: messi
Buscar Eventos
Encontre eventos por palavra-chave para planejar a cobertura da mídia ou calendários editoriais.
- Método: GET
- URL: https://zylalabs.com/api/11904/facebook-scraper-api/22642/search-events
- Parâmetro de consulta obrigatório:
- query: um termo de busca. Exemplo: cerveja
A resposta inclui resultados (com tipo "search_event", event_id, title, url) e pode incluir uma string de cursor que você pode armazenar para continuar uma busca mais tarde, se necessário.
Exemplo em Python: buscar vídeos e escolher os campos que você precisa
Este exemplo chama Buscar Vídeos com query=futebol, extrai os campos essenciais e imprime uma lista compacta que está pronta para ser inserida em uma interface ou pipeline. Substitua YOUR_API_KEY pela sua chave.
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")
Dicas:
- Armazene video_id como uma chave estável. A URL é boa para exibição, mas o ID é o que você usará para deduplicação.
- time_and_views_raw é uma string legível por humanos; se você precisar de números, mantenha como está ou faça uma análise conservadora.
- Registre e tente novamente 429/5xx de acordo com sua abordagem padrão de retrocesso. O hub é por assinatura + cota; mantenha-se dentro da alocação de solicitações do seu plano.
Exemplo oficial: chamando outro endpoint para detalhes do perfil
A listagem também inclui um endpoint de busca de perfil. O seguinte é um exemplo oficial do marketplace—útil se você aumentar os resultados de vídeo com metadados 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 você provavelmente usará:
- profile.name, profile.profile_id, profile.url para identidade e vinculação
- profile.image e profile.cover_image para UI
- profile.verified para sinalizar confiança
Trabalhando com respostas: notas práticas
- Tempo e visualizações: Buscar Vídeos retorna um “time_and_views_raw” legível por humanos. Mantenha como um rótulo ou faça uma análise cautelosa.
- Thumbnails: thumbnail é uma URL de imagem direta; não faça hotlinking agressivamente em UIs de alto tráfego sem o devido cache/CDN.
- Paginação/cursors: as respostas de Buscar Eventos podem incluir uma string de cursor. Persista-a se você planeja paginar ou retomar varreduras mais tarde.
- Deduplicação: use video_id como a chave primária em seu DB. Combine com author.id para escopo de análises.
- Cotas: o hub funciona por assinatura + cota, não por chamada. Inspecione seu plano na página da API e monitore o uso em seu painel Zyla.
Fluxos de trabalho de mídia do mundo real
- Descoberta de conteúdo para editores: execute Buscar Vídeos em atletas, programas ou tópicos nomeados a cada hora. Armazene video_id, título, autor e time_and_views_raw para classificação.
- Monitoramento de marca: consulte nomes de produtos ou campanhas e envie video_url correspondente para equipes de moderação ou comunidade.
- Fonte de canal: use Buscar Páginas para encontrar fontes de vídeo prováveis, depois concentre a varredura a jusante ou a cobertura editorial nessas páginas.
- Curadoria orientada por eventos: Busque Eventos para festivais ou lançamentos futuros e prepare suas listas de vídeos em torno dos títulos dos eventos.
Chamada de agentes de IA via MCP
Você pode chamar qualquer API Zyla de clientes compatíveis com MCP (como Claude Code, Cursor, Windsurf). Os agentes falam com o endpoint MCP da Zyla em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY e, em seguida, invocam as ferramentas desta API pelo caminho. Consulte a referência MCP para detalhes de integração. Mantenha a mesma chave de autorização bearer ao invocar endpoints e prefira IDs estáveis (video_id) na memória do agente.
Referência: endpoints e parâmetros obrigatórios
Buscar Vídeos
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22641/search-videos
- Parâmetros: query (string, obrigatório). Exemplo de valor: futebol
Buscar Páginas
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22640/search-pages
- Parâmetros: query (string, obrigatório). Exemplo de valor: messi
Buscar Eventos
- GET https://zylalabs.com/api/11904/facebook-scraper-api/22642/search-events
- Parâmetros: query (string, obrigatório). Exemplo de valor: cerveja
Todas as solicitações requerem: Authorization: Bearer YOUR_API_KEY
Explore outras listagens de mídia e redes sociais em zylalabs.com. Sua mesma chave de API funciona em todo o hub.
FAQ
Como faço para autenticar solicitações?
Envie Authorization: Bearer YOUR_API_KEY em cada solicitação para a URL da API Zyla.
Quais campos posso confiar nos resultados da busca de vídeos?
Para cada item nos resultados: type, video_id, video_url, title, description, author{name, url, is_verified, id}, thumbnail e time_and_views_raw.
Há paginação?
As respostas de Buscar Eventos incluem uma string de cursor que você pode armazenar para paginação ou retomar varreduras. Para outros endpoints, trate os arrays de resultados como retornados.
Quais são os limites de uso?
O uso é por assinatura + cota, não por chamada. O acesso pela primeira vez normalmente oferece um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Posso chamar isso de um agente de IA?
Sim. Use o endpoint MCP em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY de um cliente compatível com MCP e, em seguida, invoque as ferramentas desta API com sua chave bearer.
Pronto para enviar sua integração de busca de mídia? Comece seu teste na API Facebook Scraper, obtenha sua chave de API e implemente a busca de vídeos hoje.
Resposta oficial da 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":"…
Resposta oficial da 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":"…