Pricing

Rating

Developer

Actor stats

Categories

Share

🧵 Threads Scraper — Documentação Oficial

O Threads Scraper é uma solução unificada para extração de dados públicos do Meta Threads. Desenvolvido para máxima eficiência, ele permite coletar dados de perfis, hashtags, buscas por keywords, posts individuais e feeds sem a necessidade de login ou tokens oficiais da API da Meta.

🚀 Visão Geral

Este Actor foi desenhado para ser plug-and-play. Ideal para times de marketing, growth engineers, pesquisadores de dados e desenvolvedores de SaaS que precisam de inteligência competitiva e social listening em escala.

• Zero Setup: Sem necessidade de login ou proxy complexo.
• Escalabilidade: Suporta input em massa (bulk) de até 100 entradas por execução.
• Custo-Benefício: Modelo pay-as-you-go de $0.005 por resultado, sem taxas de adesão.

📊 Data Points (Campos Extraídos)

Para cada post processado, o scraper entrega um dataset estruturado com os seguintes campos:

Objeto: Post

• postId, postUrl: Identificadores únicos.
• content: Conteúdo textual completo.
• publishedAt: Timestamp original e formatado (ISO).
• metrics: Contagens de likes, replies, reposts, shares, views e quotes.
• media: Detecção de tipo (photo, video, carousel) e lista de URLs de mídia.
• threadParts[]: Agrupamento automático de posts encadeados (threads longas).

Objeto: Autor & Respostas

• author: Handle do usuário.
• replies[]: (Apenas no modo post) Lista das 20 principais respostas, incluindo autor e conteúdo.

Nota Técnica: Os nomes dos campos (chaves do JSON) são mantidos em inglês para garantir compatibilidade com pipelines de dados internacionais e bibliotecas de integração.

⚙️ Modos de Operação

O Scraper opera em 5 modos distintos, selecionáveis via parâmetro mode:

🛠️ Configuração de Entrada (Inputs)

💡 Exemplos de Uso

Extração de Perfis (JSON)

{
"mode":"user",
"usernames":["zuck","mosseri"],
"maxPosts":100
}

Monitoramento de Tendências (Keyword Search)

{
"mode":"search",
"keywords":["Inteligência Artificial","SaaS"],
"searchSort":"recent",
"dateFrom":"1 month"
}

⚠️ Notas e Limites Técnicos

• Early Exit: O scraper possui inteligência para interromper a execução caso detecte feeds inativos, economizando créditos.
• Normalização de Métricas: Valores abreviados pelo Threads (ex: 10K) são automaticamente convertidos para inteiros (10000) para facilitar cálculos.
• Dados Públicos: O acesso é limitado a conteúdos visíveis sem login. Perfis privados não são acessíveis.
• Threads Encadeadas: Posts divididos em várias partes são mesclados em um único registro no campo threadParts[].

❓ Perguntas Frequentes (FAQ)

Como passar os usernames corretamente? Utilize apenas o handle simples: usuario, sem o símbolo @. O sistema limpa automaticamente URLs caso você as insira por engano.

Quais formatos de exportação são aceitos? Como o Scraper roda na infraestrutura Apify, você pode exportar em JSON, CSV, Excel, XML ou HTML Table.

Por que não usar a API Oficial da Meta? A API oficial é voltada para gestão de conteúdo próprio. Para Pesquisa de Mercado e Análise Competitiva, o Scraper é mais ágil, não exige aprovação de App e oferece acesso a dados que a API restringe.

⚖️ Aviso Legal e Compliance

Este software coleta apenas dados publicamente disponíveis. O uso desta ferramenta deve estar em conformidade com as regulamentações locais de proteção de dados (como a LGPD no Brasil e GDPR na Europa). Recomendamos o uso ético para fins de pesquisa, monitoramento de marca e analytics.

Desenvolvido para profissionais de dados que buscam agilidade e precisão no ecossistema Meta.