Social Fetch

API de raspagem para TikTok, Instagram, YouTube, X e mais.

Ver em socialfetch.devExperimente este MCPPatrocinado

Documentação

Para agentes de codificação e LLMs: Esta é uma página da documentação do Social Fetch (exportação em markdown). Para orientação selecionada e orientação de fluxo de trabalho, comece com /llms.txt; para integração de agentes e regras de rastreamento, use /agents.txt; para a lista completa de endpoints com links para páginas como esta, use /llms-endpoints.txt; para parâmetros e curls de uma plataforma, use /llms-{platform}.txt; use /llms.json quando precisar de JSON estruturado para registro de ferramentas.

Esta página

On-site (HTML): https://www.socialfetch.dev/docs
URL Markdown (.mdx): https://www.socialfetch.dev/docs.mdx

URL base da API e autenticação

Origem da API (do OpenAPI servers): https://api.socialfetch.dev
Autenticação: envie x-api-key: sfk_... nas rotas /v1/** e /v2/**, a menos que a operação seja explicitamente anônima (verifique o OpenAPI security, o hub de referência da API, /llms.txt ou /llms.json para cada rota).
JSON do OpenAPI: https://www.socialfetch.dev/openapi.json

Pontos de entrada recomendados da documentação (neste site)

Visão geral da documentação — orientação de nível superior (markdown).
Início rápido — autentique-se com x-api-key, valide a autenticação com whoami e entenda o envelope JSON.
SDK — guia oficial do SDK TypeScript, incluindo SocialFetchClient, Result e unwrap().
Matriz de capacidades — todas as operações com identificadores, paginação, resultados, download de mídia, créditos e seu método SDK. Gerada a partir do OpenAPI, use-a para seleção de rotas em vez de examinar páginas individuais.
Receitas — fluxos de trabalho copiáveis (monitoramento de marca, transcrições, Ad Library, pontuação de criadores, pesquisa no Reddit) com avisos de crédito e exemplos de SDK.
Integrações — MCP para clientes de IA, nó verificado do n8n, Apify Store Actors, aplicativo personalizado do Make, SDK e caminhos de conexão da API REST.
Página do produto MCP — visão geral do MCP hospedado, OAuth, instalação de Skills.
Integração MCP — servidor /mcp hospedado, OAuth, trechos de instalação para Cursor/VS Code/Claude, 240 ferramentas de endpoint, além de docs_search/docs_read para ajuda na implementação.
Integração n8n — instale n8n-nodes-socialfetch, credenciais e exemplos de fluxo de trabalho.
Integração Apify — Store Actors sob @social-fetch, cobrança PPE, exportação de conjuntos de dados e início rápido.
Integração Make — módulos de aplicativo personalizado para cenários do Make, credenciais de chave de API e catálogo de módulos.
/llms-endpoints.txt — todas as operações documentadas com um link direto para a página markdown legível por agente daquela rota (prefira isso em vez de analisar o OpenAPI).
/llms-{platform}.txt — arquivos de endpoint por plataforma gerados a partir do OpenAPI (parâmetros, créditos, curls).
/agents.txt — arquivo de rastreamento/integração para agentes com capacidades, regras de autenticação e lista de permissões.
/llms.json — inventário estruturado de operações legível por máquina com nomes de parâmetros, paginação, resultados, créditos e mapeamento de SDK.
Hub de referência da API — índice amigável de operações com links para páginas geradas.
Erros — envelope de erro compartilhado e orientação de status HTTP.
Créditos — medição, 402 e planejamento de trabalhos em lote.
Semânticas de resultado como found, not_found e private são documentadas em Erros e nas páginas de operação quando presentes no contrato OpenAPI.

Convenção de documentação em Markdown

Toda página de documentação tem um equivalente em markdown: acrescente .mdx ao caminho da documentação (por exemplo, /docs/quickstart → /docs/quickstart.mdx).
Agentes que enviam Accept: text/markdown em URLs HTML /docs/** podem receber markdown diretamente (mesma URL, Vary: Accept).
Postagens de blog publicadas usam a mesma convenção: /blog/{slug} → /blog/{slug}.mdx, ou Accept: text/markdown na URL HTML (Vary: Accept).

Documentação (https://www.socialfetch.dev/docs)

Social Fetch é uma API REST para dados normalizados de mídias sociais. Consulte perfis, postagens e métricas de engajamento no Instagram, TikTok, X/Twitter, YouTube e muito mais — um único formato JSON, uma única chave de API.

URL base https://api.socialfetch.dev · autentique-se com o cabeçalho x-api-key: sfk_... · obtenha a especificação em /openapi.json. Novo por aqui? Comece com o Início rápido.

Escolha seu caminho

Início rápido — Faça sua primeira solicitação autenticada e aprenda o envelope de resposta em poucos minutos.
Receitas — Fluxos de trabalho copiáveis — monitoramento de marca, transcrições, anúncios, pontuação de criadores, pesquisa no Reddit.
SDK TypeScript — Métodos de cliente tipados e tratamento de erros baseado em Result em vez de HTTP bruto.
Referência da API — Todas as operações, com parâmetros, exemplos e esquemas de resposta.
Créditos e cobrança — Quais rotas custam créditos, como ler creditsCharged e o que 402 significa.
Integrações — SDK, MCP, n8n, Apify, x402 — conecte o Social Fetch à sua stack.

Não sabe por onde começar? Combine com sua configuração:

Chamando a API diretamente — Início rápido → Erros → Créditos → Referência da API.
Desenvolvendo em TypeScript — Início rápido → Guia do SDK.
Entregando isso a um agente de codificação — conecte o MCP ou aponte-o para /llms.txt, /agents.txt, /llms.json e /openapi.json.

Cobertura de plataformas

Toda plataforma retorna o mesmo envelope { data, meta }.

Instagram — perfis, postagens, reels, destaques, pesquisa
TikTok — perfis, vídeos, produtos, pesquisa de usuários
X/Twitter — perfis, tweets, comunidades, pesquisa
YouTube — canais, vídeos, transcrições, playlists, pesquisa
Yelp — avaliações de negócios paginadas retornadas diretamente pela API (a disponibilidade da fonte varia por categoria de avaliação)
Facebook, Reddit, LinkedIn, Pinterest, Threads, Bluesky, Twitch, GitHub, Rumble, Spotify, Apple Music, SoundCloud, Snapchat, Telegram, Linktree, Hacker News, Truth Social, Google, Amazon — perfis, postagens e consultas específicas da plataforma
Web — busque qualquer página como Markdown ou HTML, ou faça uma pergunta sobre ela
Monitores e webhooks — agende verificações recorrentes e receba entregas assinadas
Utilitários — whoami, balance e health

Consulte a Referência da API para todas as operações e seus esquemas.

Documentação para máquinas

Desenvolvendo com um agente de codificação ou gerando código de cliente:

Acrescente .mdx a qualquer URL de documentação para obter o Markdown bruto, por exemplo, /docs/quickstart.mdx.
/llms.txt — índice de descoberta selecionado: cobertura, por que usar, links de documentação orientados a fluxo de trabalho (~100 linhas).
/agents.txt — integração de agentes, regras de autenticação/paginação e lista de permissões de rastreamento.
/llms-endpoints.txt — todas as operações com um link para a página markdown daquela rota.
/llms-{platform}.txt — arquivos por plataforma com parâmetros, créditos e exemplos de curls (do OpenAPI).
/llms.json — inventário estruturado de rotas com parâmetros, paginação, resultados, créditos e mapeamentos de SDK.
/openapi.json — esquema completo para geração de código, validação e ferramentas.
Matriz de capacidades — todas as operações em uma tabela gerada: identificadores, paginação, resultados, créditos e método SDK. Prefira /llms.json para agentes.