Visão geral da API do Ayrshare - Ayrshare API Documentation

A REST API de Redes Sociais oferece aos desenvolvedores acesso programático a várias redes sociais por meio de uma única interface unificada. Através da API social do Ayrshare, você pode gerenciar atividades de mídia social, incluindo criar e excluir publicações, obter analytics, engajar com comentários e avaliações, gerenciar mensagens diretas, criar anúncios do Facebook e realizar outras ações em várias plataformas. Atualmente, a API suporta 13 grandes redes sociais: Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, Threads, TikTok, X (antigo Twitter) e YouTube. Ao integrar com esta API, desenvolvedores podem automatizar tarefas de gerenciamento de mídia social em todas essas plataformas simultaneamente. Os dados de requisição e resposta das chamadas da API estão em formato JSON, o que permite fácil parsing e processamento na maioria das linguagens de programação. Se você estiver no plano Launch, Business ou Enterprise, consulte a Visão geral do plano Business, a Visão geral do plano Launch e o endpoint /profiles da API.

Principais funcionalidades

13 redes sociais suportadas.
Acesso seguro à API usando sua API Key exclusiva.
Agendamento de publicações para plataformas de mídia social conectadas.
Publicação automatizada com base em agendamentos predefinidos.
Suporte a conteúdo em imagem e vídeo, incluindo Reels, Stories e Spotlight.
Excluir publicações nas redes sociais vinculadas.
Analytics abrangentes de engajamento por publicação (curtidas, compartilhamentos, etc.).
Métricas de conta social, incluindo contagem de seguidores e dados demográficos.
Gerenciamento de comentários: visualizar, adicionar e excluir comentários de publicações.
Encurtamento opcional de links para todas ou URLs específicas em publicações.
Integração com Unsplash: adicione imagens específicas ou selecione aleatoriamente com base em palavras-chave.
Opção de geração automática de hashtags usando palavras-chave relevantes.
Rastreamento de histórico de publicações, incluindo publicações não feitas via Ayrshare.
Gerenciamento de avaliações: obter, responder e excluir respostas a avaliações.
Integração de feeds RSS para publicação automatizada de conteúdo.
Biblioteca de mídia: envie e armazene fotos e vídeos para uso em publicações.
Sistema de verificação de publicações sociais para manter suas contas sociais seguras.

Plano Business e plano Launch

Recursos do plano Business e do plano Launch para gerenciar múltiplos usuários e clientes:

Permite que os usuários vinculem suas próprias contas de mídia social à sua plataforma.
Single sign-on seguro usando OAuth para vinculação rápida de contas.
Criar e remover perfis de usuário programaticamente através da API.
Acesse analytics avançadas de usuários.
Suporte a webhooks para atualizações em tempo real.
Gerenciamento de mensagens diretas nas plataformas suportadas.
Criar anúncios do Facebook a partir de publicações existentes.

Entre em contato para saber mais sobre o plano Business.

API de Ads

A API de Ads permite criar anúncios do Facebook a partir de publicações existentes.

Impulsione publicações para alcançar mais pessoas.
Gerencie anúncios e acompanhe o desempenho.
Analise o gasto em anúncios e otimize campanhas.

API de Ads

Explore a API de Ads

API de Mensagens

Uma API de mensagens unificada para engajar usuários em conversas nos principais canais de mídia social: Facebook, Instagram e X.

Envio de mensagens de texto, imagem e vídeo.
Recuperação de históricos completos de conversas.
Configuração de respostas automáticas a mensagens.
Recebimento de atualizações em tempo real via webhooks para mensagens recebidas, reações a mensagens e confirmações de leitura.

Esta API simplifica o engajamento com usuários ao centralizar as operações de mensagens de múltiplos canais de mídia social. Saiba mais…

API de Mensagens

Explore a API de mensagens unificada

Max Pack

Obtenha ainda mais recursos com o add-on Max Pack:

Max Pack

Desbloqueie recursos avançados como geração de conteúdo com IA, analytics aprimoradas e suporte expandido a plataformas com nosso add-on Max Pack.

Se você estiver desenvolvendo em Node.js, confira este vídeo sobre como conectar e publicar publicações no X e no Facebook.

Se você usar Node.js, veja o código de demonstração da API social para começar a construir sua própria integração.

Demonstração da API social

Explore nosso código de demonstração em Node.js para acelerar sua integração com a API social

URL base

A URL base para a API do Ayrshare é a mesma para todos os endpoints. https://api.ayrshare.com/api

Autorização

O Ayrshare autentica as requisições da API por meio de um token Authorization passado no cabeçalho HTTP. Certifique-se de enviar Bearer com a API Key. A API Key pode ser encontrada no Ayrshare Dashboard alternando para seu Primary Profile. Se você for um usuário Business ou Enterprise, poderá criar User Profiles com Profile Keys para gerenciar múltiplos clientes. A Profile Key é usada no cabeçalho de suas requisições. A API Key também deve ser usada no cabeçalho de suas requisições para User Profiles.

Planos Premium devem usar apenas a API Key no cabeçalho de suas requisições. Planos Business e Enterprise devem usar a Profile Key no cabeçalho de suas requisições ao interagir em nome de um User Profile.

Formato da API Key

Authorization: Bearer API_KEY substituindo API_KEY pela API Key do seu Primary Profile, que pode ser encontrada no Ayrshare Dashboard.

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

Obtenha sua API Key secreta no Ayrshare Dashboard, na página API Key encontrada no painel de navegação à esquerda.Por exemplo, se sua API Key for 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EASeu cabeçalho deve incluir:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Formato da Profile Key

Uma Profile Key é usada para interagir em nome de um User Profile. Isso só está disponível para planos Business ou Enterprise. Profile-Key: PROFILE_KEY substituindo PROFILE_KEY pela Profile Key de um usuário. Incluir uma Profile Key no cabeçalho é obrigatório para interagir em nome de um User Profile. A falta da API Key do Primary Profile ou o uso da Profile Key no lugar da API Key no cabeçalho resultará em erro. Veja como estruturar os cabeçalhos para requisições da API:

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

Encontre a Profile Key no Ayrshare Dashboard, na página Profile Key encontrada no painel de navegação à esquerda. Alterne para o Profile que você deseja usar na página User Profile. Adicionalmente, a Profile Key é retornada na resposta do endpoint Criar um User Profile.Você pode então usar a Profile Key no cabeçalho das suas requisições:Por exemplo, se sua Profile Key for AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EASeu cabeçalho deve incluir tanto a API Key quanto a Profile Key:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

Credenciais BYO do X/Twitter

A partir de 31 de março de 2026, todas as operações do X/Twitter através do Ayrshare exigem suas próprias credenciais OAuth 1.0a. Após vincular sua conta do X via OAuth, passe estes 2 cabeçalhos junto com seus cabeçalhos Authorization (e Profile-Key opcional) em qualquer requisição direcionada ao X/Twitter:

Cabeçalho	Descrição
`X-Twitter-OAuth1-Api-Key`	Sua OAuth 1.0a API Key (Consumer Key)
`X-Twitter-OAuth1-Api-Secret`	Sua OAuth 1.0a API Key Secret (Consumer Secret)

Estes cabeçalhos são obrigatórios após 31 de março de 2026. As requisições aos endpoints do X/Twitter sem credenciais BYO válidas serão rejeitadas.

Um único par de chaves, usado em todas as requisições. Você cria um X Developer App por conta do Ayrshare e usa os mesmos valores de X-Twitter-OAuth1-Api-Key e X-Twitter-OAuth1-Api-Secret em toda requisição direcionada ao X, independentemente de qual subperfil (Profile-Key) seja o destinatário da requisição. Você não gera nem rotaciona chaves por cliente ou por usuário final.

Consulte o Guia de configuração das X BYO Keys para instruções passo a passo, exemplos de código e resolução de problemas. Os mesmos dois cabeçalhos se aplicam ao usar o X/Twitter através do Servidor MCP — consulte Conectar & configurar.

Content Type

O Content Type deve sempre ser definido como Content-Type: "application/json", a menos que o endpoint especifique outra coisa.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

Compressão

O Ayrshare suporta compressão para todas as requisições da API. Para ativar a compressão, defina o cabeçalho Accept-Encoding como deflate, gzip, br.

  Accept-Encoding: "deflate, gzip, br"

Isto é recomendado para chamar respostas maiores, como o endpoint /history.

Apenas respostas com mais de 1024 bytes (1KB) são comprimidas.
A ordem de compressão utilizada: Brotli (br) primeiro, depois gzip, depois deflate. Brotli é o algoritmo de compressão mais eficiente.
O cabeçalho da resposta contém a codificação de conteúdo utilizada. Por exemplo: content-encoding: br se Brotli foi usado.
Saiba mais sobre compressão e os benefícios do seu uso no Blog do Ayrshare.

Não se esqueça de descomprimir corretamente a resposta usando a codificação de conteúdo.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -H "Accept-Encoding: deflate, gzip, br" \ 
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json",
  "Accept-Encoding" => "deflate, gzip, br"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

Tipos de ID

Existem vários tipos de IDs retornados, que podem ser usados em diversos endpoints:

Ayrshare Post ID

Este ID é gerado pelo Ayrshare e retornado do endpoint /post no campo id. Este ID facilita obter analytics da publicação em várias redes sociais, adicionar comentários à publicação, excluir a publicação, etc. Este é o ID que você usará com mais frequência. Cada rede social atribui seu próprio ID único a publicações e comentários. Esses IDs são retornados no campo postIds dos endpoints /post ou /comments. Você pode usar esses IDs, ou os que obtiver diretamente das redes sociais, para recuperar dados, como com o social post ID de analytics.

Ayrshare Comment ID

Este ID é gerado pelo Ayrshare e retornado do endpoint /comments no campo id. Este ID facilita obter analytics do comentário em várias redes sociais, adicionar respostas ao comentário, excluir o comentário, etc. Este é o ID que você usará com mais frequência. Frequentemente é usado quando você quer obter detalhes de um comentário específico publicado via Ayrshare. Cada rede social atribui seu próprio ID único aos comentários. Esses IDs são retornados no campo commentId do endpoint GET /comments. Frequentemente é usado quando você quer obter detalhes de um comentário específico publicado fora do Ayrshare.

Códigos de erro

Os erros retornam com códigos de status HTTP padrão. Para mais informações:

Códigos de status HTTP

Saiba mais sobre códigos de status HTTP

Erros detalhados estão na resposta da REST API, específicos para cada tipo de chamada. Para mais informações:

Códigos de erro do Ayrshare

Saiba mais sobre os códigos de erro específicos do Ayrshare

Formato de timestamp

O Ayrshare usa Zulu Time, também conhecido como UTC (Tempo Universal Coordenado) ou uma string de data no formato ISO 8601, para referências de horário precisas e sem ambiguidade entre diferentes fusos horários. Por exemplo, use o formato YYYY-MM-DDThh:mm:ssZ e envie como 2026-07-08T12:30:00Z. Consulte utctime para mais exemplos. Você pode converter o formato UTC para seu horário local na linguagem de programação de sua escolha. Por exemplo, em JavaScript:

const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};

Postman

Você pode usar o Postman para testar suas chamadas da REST API.

Postman

Aprenda a usar o Postman com nossa API

Publicações, imagens e vídeos aleatórios

Confira o guia de início rápido sobre como enviar publicações, imagens ou vídeos aleatórios ao testar.

Pacotes

Temos pacotes para Node.js e Python, além de guias para Bubble.io, Airtable e Make para facilitar as chamadas RESTful.

Pacote NPM para Node

Integre usando nosso pacote NodeJS

Pacote PyPI para Python

Integre usando nosso pacote Python

Guia do Airtable

Aprenda a usar o Ayrshare com o Airtable

Plugin & Guia do Bubble

Aprenda a usar o Ayrshare com o Bubble.io

Guia do Make

Aprenda a usar o Ayrshare com o Make

Guia do Notion

Aprenda a usar o Ayrshare com o Notion

Guia do FlutterFlow

Aprenda a usar o Ayrshare com o FlutterFlow

Guia do Retool

Aprenda a usar o Ayrshare com o Retool

​Principais funcionalidades

​Plano Business e plano Launch

​API de Ads

API de Ads

​API de Mensagens

API de Mensagens

​Max Pack

Max Pack

​Assista como usar a API social

​Demonstração da API social

Demonstração da API social

​URL base

​Autorização

​Formato da API Key

​Formato da Profile Key

​Credenciais BYO do X/Twitter

​Content Type

​Compressão

​Tipos de ID

​Ayrshare Post ID

​Social Post ID

​Ayrshare Comment ID

​Social Comment ID

​Códigos de erro

Códigos de status HTTP

Códigos de erro do Ayrshare

​Formato de timestamp

​Postman

Postman

​Publicações, imagens e vídeos aleatórios

​Pacotes

Pacote NPM para Node

Pacote PyPI para Python

Guia do Airtable

Plugin & Guia do Bubble

Guia do Make

Guia do Notion

Guia do FlutterFlow

Guia do Retool

Principais funcionalidades

Plano Business e plano Launch

API de Ads

API de Mensagens

Max Pack

Assista como usar a API social

Demonstração da API social

URL base

Autorização

Formato da API Key

Formato da Profile Key

Credenciais BYO do X/Twitter

Content Type

Compressão

Tipos de ID

Ayrshare Post ID

Social Post ID

Ayrshare Comment ID

Social Comment ID

Códigos de erro

Formato de timestamp

Postman

Publicações, imagens e vídeos aleatórios

Pacotes