Limite de requisições da API

Para preservar a integridade e a confiabilidade da plataforma, as nossas APIs têm o seguinte limite de taxa:

Contatos

Limite de requisições para atualização do contato

Limite máximoPeríodoMétodo HTTPPlano
24 Requisições24 horasPATCHLight, Basic, Pro, Enterprise

Limite de requisições para melhor horário para mensagem

Limite máximoPeríodoMétodo HTTPPlano
60 Requisições1 horaGETLight, Basic, Pro, Enterprise

Criar Tag Lead

Limite de requisições do lead

Limite máximoPeríodoMétodo HTTPPlano
120 Requisições24 horasPOSTLight, Basic, Pro, Enterprise

Limite de requisições por conta

Limite máximoPeríodoMétodo HTTPPlano
120 Requisições1 minutoPOSTLight, Basic, Pro
500 Requisições1 minutoPOSTEnterprise

Segmentações

Limite de requisições da lista de segmentações

Limite máximoPeríodoMétodo HTTPPlano
120 Requisições1 minutoGETLight, Basic, Pro, Enterprise

Funis de Contatos

Limite de requisições do lead

Limite máximoPeríodoMétodo HTTPPlano
24 Requisições24 horasGET, PUTLight, Basic, Pro, Enterprise

Limite de requisições por conta

Limite máximoPeríodoMétodo HTTPPlano
1.000.000 Requisições24 horasGET, PUTLight, Basic, Pro, Enterprise

Campos Personalizados

Limite de requisições por conta

Limite máximoPeríodoMétodo HTTPPlano
1.000.000 Requisições24 horasGET, POST, PATCH, DELETELight, Basic, Pro, Enterprise

Webhooks

Limite de requisições por conta

Limite máximoPeríodoMétodo HTTPPlano
1.000.000 Requisições24 horasGET, POST, PUT, DELETELight, Basic, Pro, Enterprise

Eventos

Limite de requisições do lead

Limite máximoPeríodoMétodo HTTPPlano
120 Requisições24 horasPOSTLight, Basic, Pro, Enterprise

Limite de requisições por conta

Limite máximoPeríodoMétodo HTTPPlano
120 Requisições1 minutoPOSTLight, Basic, Pro
500 Requisições1 minutoPOSTEnterprise

Análise

Limite de requisições para consultar estatísticas de e-mail marketing

Limite máximoPeríodoMétodo HTTPPlano
60 Requisições1 horaGETEnterprise

Limite de requisições para consultar estatísticas de e-mail via fluxo de automação

Limite máximoPeríodoMétodo HTTPPlano
60 Requisições1 horaGETEnterprise

Too Many Requests

Ao projetar seu aplicativo pense em controlar o fluxo de solicitações de API para uma melhor produtividade sem exceder o máximo de requisições permitido, caso contrário, você receberá um erro 429 - Too Many Requests.

Exemplo
{
  "error": "'lead_limiter' rate limit exceeded for 86400 second(s) period for key '[email protected]'",
  "max": 24,
  "usage": 25,
  "remaining_time": 43067
}

error: Detalhes sobre a causa que excedeu o limite de requisições permitido
max: Número máximo de requisições permitido
usage: Número máximo de requisições alcançado
remaining_time: Período restante para envio de requisições (milissegundos)

👍

Dicas rápidas

  • Assuma que sua aplicação irá competir por cotas, taxas e recursos de concorrência com outros aplicativos, defina limites de uso conservadores.
  • Evite fazer chamadas de API simultâneas se o seu caso de uso não se beneficiar.
  • Sempre que possível utilize requisições assíncronas para as APIs, assim você poderá lidar melhor com os limites e erros.