A API (interface de programação de aplicativos) é uma forma de extrair dados não tratados da Semrush sem precisar fazer login manualmente no software. A Semrush oferece duas opções principais de API:
- Pacote de API Padrão (APIs de Análises e Projetos)
- API do Traffic Analytics
Esta API está disponível como suplemento a uma assinatura Business. O Pacote de API Padrão vem com as APIs de Análises e Projetos. Ao atualizar para a assinatura Business, você tem a possibilidade de comprar unidades de API e gerar uma chave de API. É importante saber que, ao atualizar para o plano Business, o número de unidades continuará igual a zero. Você precisa comprar a quantidade adequada de unidades de API conforme suas necessidades. Se um determinado número de unidades estiver incluso no seu plano de assinatura desde o começo, ele vai expirar se a assinatura for interrompida.
Sempre que suas unidades acabarem, você pode comprar mais na página Informações da assinatura ou entrando em contato conosco.
Veja como obter uma API aqui.
- Com a API de Análises, você pode solicitar dados dos relatórios analíticos, incluindo:
- Com a API de Projetos, você pode solicitar dados das campanhas de Monitoramento de posição e Auditoria do site criadas nos projetos.
É possível obter dados de subpastas e subdomínios por meio da API. Verifique a seção Subdomínio e Subpasta na documentação da API para ver de quais relatórios você pode extrair dados.
As chamadas às APIs de Análises e Projetos custam uma determinada quantidade de unidades de API. A quantidade total de unidades que você gastará depende do tipo de solicitação ou do número exato de linhas do relatório.
Você pode conferir seu saldo de unidades de API na guia Informações da assinatura ou fazendo uma solicitação grátis à API (saldo de unidades de API).
Veja a lista completa de relatórios da Semrush que a API pode consultar aqui. Sua chave de API fica disponível na página Informações da assinatura.
A API do Traffic Analytics está disponível somente para assinantes da Semrush e vem em 2 planos:
- Básico: fornece somente dados gerais do tráfego
- Avançado: fornece dados gerais do tráfego + 8 relatórios distintos
API Básica
Os dados da Visão geral do tráfego podem te mostrar estimativas do comportamento dos visitantes de um site. Isso inclui visitas mensais, visitas únicas, páginas por visita, duração média das visitas, porcentagem de tráfego de dispositivos móveis x computadores e taxa de rejeição.
Da mesma forma, o relatório Visão geral do Traffic Analytics pode comparar até 5 domínios ao mesmo tempo, e você pode buscar esses dados para até 200 domínios em uma única solicitação usando os Relatórios de resumo. Esses dados fornecem uma visão rápida do nível geral de interação dos visitantes com um site.
As chamadas da API de análise de tráfego funcionam para raiz, subdomínios e subpastas, exceto para Domain Rankings, Audience Insights e Data Accuracy.
API Avançada
A API Avançada (veja os detalhes completos na documentação da API) oferece até 8 relatórios distintos em complemento à Visão geral do tráfego da API Básica:
- Fontes de tráfego: tráfego do site dividido em tráfego direto, de referência, de pesquisa, de redes sociais e pago;
- Destinos do tráfego: para onde os usuários vão após visitar o domínio que você está analisando;
- Distribuição geográfica: países, regiões ou subcontinentes de onde o site obtém a maior parte de seus visitantes;
- Subdomínios: subdomínios do site responsáveis por obter a maior parte do tráfego;
- Principais páginas: número de visualizações únicas da página, visitantes únicos, entradas e fontes de tráfego de até 1.000 principais páginas do site, com base no tráfego;
- Rankings do domínio: principais sites no local selecionado para o período selecionado, ordenados por tráfego;
- Insights de público-alvo: domínios adicionais visitados, público único, porcentagem do público compartilhado e público compartilhado dos domínios informados;
- Precisão dos dados: precisão estimada do relatório com base no tamanho do domínio e qualquer filtro que você tenha aplicado (dados históricos, local, dispositivo).
O limite mensal incluído por padrão é de 10.000 solicitações. A API não usa unidades de API vinculadas ao Pacote de API Padrão da Semrush para assinaturas Business.
Se você tiver interesse em nossa API do Traffic Analytics, pode acessá-la na página Informações da assinatura.
Outra opção é entrar em contato com sales@semrush.com, e forneceremos um orçamento que atenda às suas necessidades.
Para comprar a API do Traffic Analytics, você precisará de uma conta paga da Semrush. Você pode comprar o acesso à API por conta própria ou com nossos representantes de vendas. A chave de API será enviada para seu e-mail.
As páginas da documentação da API abaixo serão essenciais para trabalhar com a API, pois cada chamada é detalhada e explicada nelas. O formato correto também será exibido para que você possa estruturar corretamente as chamadas à API. Essas chamadas podem ser feitas colando sua chamada à API em um navegador.
Acesse os links da documentação abaixo para encontrar ajuda sobre a API:
- Resumo da API
- Termos de Serviço da API
- API de Análises (Análise de domínio, Análise de palavras-chave, Análise de backlinks, etc.)
- API de Projetos (Monitoramento de posição, Auditoria do site)
- Saldo de unidades de API
- Documentação da API do Traffic Analytics
É importante salientar que, na seção 2.3 dos nossos Termos de Serviço, pedimos que você não faça mais do que 10 chamadas à API por segundo:
Se você assinar a API da Semrush, além das restrições definidas acima, você concorda em (i) não fazer mais do que 10 solicitações a cada 1 segundo a partir de um mesmo endereço IP ou mais do que 10 solicitações simultâneas usando o mesmo usuário; e (ii) não armazenar as informações recebidas dos Serviços por mais de 1 (um) mês sem o consentimento expresso da Semrush por escrito. Você não pode usar os Serviços se estiver legalmente proibido de receber ou usar os Serviços segundo as leis do seu país de residência ou do país do qual você acessa ou usa os Serviços.
Fique à vontade para conferir a postagem de blog O que é API e como posso usá-la? para aprender noções básicas de APIs e como elas podem ser úteis.