Supadata

Visão geral

Supadata é uma API de extração de texto a partir de vídeos e páginas web. Ela recupera transcrições de YouTube, TikTok, Instagram, Facebook, X (Twitter) e arquivos de vídeo, obtém metadados de canais e playlists do YouTube, converte páginas web em Markdown e mapeia todos os URLs de um site. Com a integração Supadata no SquadOS, seus agentes podem processar conteúdo de vídeo e web de forma programática para análise de conteúdo, treinamento de IA e automações baseadas em texto.

• Site oficial: https://supadata.ai/
• Documentação na Composio: docs.composio.dev/toolkits/supadata

Autenticação

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
api_key	Sim	Chave de API gerada automaticamente no painel Supadata durante o processo de onboarding. Deve ser enviada no cabeçalho x-api-key em cada requisição.

Como obter a credencial

1. Acesse dash.supadata.ai e crie uma conta.
2. Conclua o processo de onboarding — a chave de API é gerada automaticamente ao final.
3. No painel, copie a chave de API exibida — esse é o valor a usar no campo api_key ao conectar no SquadOS.

Dica

Nunca compartilhe sua chave de API nem a inclua em código-fonte versionado. Use variáveis de ambiente e acesse a API apenas a partir de ambientes server-side seguros.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Supadata.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Obter informações da conta

SUPADATA_GET_ME

Recupera detalhes da organização, informações do plano e uso de créditos da conta autenticada. Use esta ação para verificar o status da conta, saldo de créditos e plano de assinatura.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter transcrição de vídeo

SUPADATA_GET_TRANSCRIPT

Obtém a transcrição de um vídeo em plataformas suportadas ou a partir de uma URL de arquivo de vídeo. Use esta ação quando precisar recuperar transcrições do YouTube, TikTok, Twitter, Instagram ou Facebook, extrair transcrições de arquivos de vídeo, obter transcrições em idiomas específicos ou escolher entre legendas nativas e transcrições geradas por IA. Para vídeos grandes, a API retorna um ID de job — use a ação SUPADATA_GET_TRANSCRIPT_BY_JOB_ID para obter o resultado final. Para vídeos menores, a transcrição é retornada imediatamente. O formato da resposta varia conforme o parâmetro text: text=true retorna texto simples; text=false retorna lista estruturada de trechos com timestamps.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Sim	URL do vídeo em qualquer plataforma suportada (YouTube, TikTok, Twitter, Instagram, Facebook) ou uma URL de arquivo. Exemplo: 'https://youtu.be/dQw4w9WgXcQ'.
lang	string	Não	Código de idioma preferido da transcrição (formato ISO 639-1, como 'en', 'es', 'fr'). Se não informado, retorna o primeiro idioma disponível. Se o idioma solicitado não estiver disponível, a API usa o primeiro idioma disponível.
mode	string ("native" | "auto" | "generate")	Não	Modo de recuperação da transcrição.
text	boolean	Não	Quando true, retorna transcrição em texto simples. Quando false, retorna transcrição estruturada com timestamps. Padrão: false.
chunkSize	integer	Não	Número máximo de caracteres por trecho da transcrição. Aplicável apenas quando text=false (modo de transcrição estruturada). Use para dividir transcrições longas em segmentos gerenciáveis.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter transcrição por ID de job

SUPADATA_GET_TRANSCRIPT_BY_JOB_ID

Recupera o resultado de um job de transcrição assíncrono pelo seu ID. Use esta ação para obter resultados de transcrições em processamento. Verifique o campo status na resposta para determinar se o job foi concluído.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
job_id	string	Sim	O ID único do job de transcrição, retornado ao submeter uma requisição de transcrição. Exemplo: '41060930-5273-4a89-80a2-9ba5ea5bc03f'.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Mapa de URLs do site

SUPADATA_GET_WEB_MAP

Rastreia um site e extrai todos os URLs encontrados. Use esta ação para criar um mapa do site, descobrir todas as páginas de um domínio ou preparar a raspagem de conteúdo em múltiplas páginas. Retorna a lista de todos os URLs descobertos durante o rastreamento.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Sim	URL do site a rastrear e extrair links. Deve ser uma URL HTTP/HTTPS válida.
lang	string	Não	Idioma preferido para o conteúdo raspado (código ISO 639-1, ex.: 'en', 'de', 'fr'). Define o cabeçalho Accept-Language para influenciar a seleção de idioma do site.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Raspar página web

SUPADATA_GET_WEB_SCRAPE

Extrai o conteúdo de qualquer página web e o converte para o formato Markdown. Use esta ação quando precisar ler e extrair texto de uma página, obter metadados (título, descrição), descobrir links presentes na página ou verificar a contagem de caracteres do conteúdo. Um crédito de API é consumido por requisição de raspagem.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Sim	URL da página web a raspar. Deve ser uma URL HTTP/HTTPS válida.
lang	string	Não	Código de idioma ISO 639-1 para solicitar o conteúdo (ex.: 'en', 'es', 'fr'). Padrão: 'en'.
no_links	boolean	Não	Se true, exclui links Markdown do conteúdo extraído. Útil para uma saída de texto mais limpa.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter metadados de canal do YouTube

SUPADATA_GET_YOUTUBE_CHANNEL

Recupera metadados de um canal do YouTube, incluindo nome, descrição, contagem de inscritos, número de vídeos, contagem de visualizações e imagens do canal. Aceita IDs de canal, handles ou URLs completas do YouTube.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do canal do YouTube. Aceita múltiplos formatos: ID do canal (ex.: 'UC_x5XG1OV2P6uZZ5FSM9Ttw'), handle (ex.: '@GoogleDevelopers') ou URL completa (ex.: 'https://youtube.com/@GoogleDevelopers').

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter vídeos de canal do YouTube

SUPADATA_GET_YOUTUBE_CHANNEL_VIDEOS

Recupera IDs de vídeos de um canal do YouTube. Retorna listas de IDs de vídeos regulares, YouTube Shorts e transmissões ao vivo. Os vídeos são ordenados do mais recente para o mais antigo. Use esta ação para obter IDs de vídeos que podem ser passados para a ação de metadados de vídeo do YouTube.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel_id	string	Sim	URL do canal do YouTube, handle (ex.: '@RickAstleyVEVO') ou ID do canal (ex.: 'UC_x5XG1OV2P6uZZ5FSM9Ttw').
type	string ("all" | "video" | "short" | "live")	Não	Tipo de vídeos a recuperar: 'all' (padrão) retorna todos os tipos; 'video' apenas vídeos regulares; 'short' apenas YouTube Shorts; 'live' apenas transmissões ao vivo.
limit	integer	Não	Número máximo de vídeos a retornar. Padrão: 30; máximo: 5000. Quando type for 'all', o limite se aplica primeiro aos vídeos regulares, depois a Shorts e transmissões ao vivo.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter metadados de playlist do YouTube

SUPADATA_GET_YOUTUBE_PLAYLIST

Recupera metadados de uma playlist do YouTube, incluindo título, descrição, contagem de vídeos, contagem de visualizações, timestamp da última atualização e informações do canal. Use esta ação quando precisar de informações sobre a playlist como um todo. Para listar os vídeos de uma playlist, use a ação SUPADATA_GET_YOUTUBE_PLAYLIST_VIDEOS.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	URL ou ID da playlist do YouTube. Suporta URLs completas (ex.: 'https://www.youtube.com/playlist?list=PLlaN88a7y2_plecYoJxvRFTLHVbIVAOoc') ou apenas o ID da playlist (ex.: 'PLlaN88a7y2_plecYoJxvRFTLHVbIVAOoc').

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter vídeos de playlist do YouTube

SUPADATA_GET_YOUTUBE_PLAYLIST_VIDEOS

Recupera IDs de vídeos de uma playlist do YouTube. Retorna listas de IDs de vídeos padrão, YouTube Shorts e transmissões ao vivo contidos na playlist.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
playlistId	string	Sim	URL ou ID da playlist do YouTube. Pode ser uma URL completa como 'https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf' ou apenas o ID como 'PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf'.
limit	integer	Não	Número máximo de IDs de vídeos a retornar. Padrão: 100; máximo: 5000.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter metadados de vídeo do YouTube

SUPADATA_GET_YOUTUBE_VIDEO

Recupera metadados completos de um vídeo do YouTube pelo seu ID. Use esta ação quando precisar de título, descrição e tags, informações do canal, contagens de visualizações e curtidas, data de upload e duração, status de transmissão ao vivo ou idiomas de transcrição disponíveis. O video_id é o identificador de 11 caracteres encontrado nas URLs do YouTube (ex.: 'dQw4w9WgXcQ' de 'https://youtube.com/watch?v=dQw4w9WgXcQ').

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
video_id	string	Sim	ID do vídeo do YouTube (string de 11 caracteres encontrada nas URLs após 'v=' ou '/watch?v='). Exemplo: 'dQw4w9WgXcQ' de 'https://youtube.com/watch?v=dQw4w9WgXcQ'.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar no YouTube

SUPADATA_SEARCH_YOUTUBE

Pesquisa vídeos, canais ou playlists no YouTube por palavra-chave. Retorna o conteúdo correspondente com metadados como títulos, thumbnails, contagens de visualizações e informações do canal.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	O termo de pesquisa a buscar no YouTube. Exemplos: 'python tutorial', 'receitas de culinária', 'videoclipes'.
type	string ("video" | "channel" | "playlist")	Não	Tipo de recurso a buscar. Se não especificado, retorna todos os tipos. Opções: 'video', 'channel', 'playlist'.
limit	integer	Não	Número máximo de resultados a retornar. Padrão: 10; máximo: 5000. Observação: consome 1 crédito por página (~20 resultados).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.