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 (rate limit):

Limite de requisições para atualização de um contato específico

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

Limite de requisições por conta

Limite máximoPeríodoMétodo HTTPPlano
120 Requisições1 MinutoGET, POST, PATCH, DELETELight, Basic, Pro
500 Requisições1 MinutoGET, POST, PATCH, DELETEAdvanced



Limite de requisições por contato/lead

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

Limite de requisições por conta

Limite máximoPeríodoMétodo HTTPPlano
15.000 Requisições1 diaPOSTLight, Basic, Pro, Advanced




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

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



Limite de requisições do lead

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

Limite de requisições por conta

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



Limite de requisições por conta

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



Limite de requisições por conta

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



Limite de requisições por lead

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

Limite de requisições por conta

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



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

Limite máximoPeríodoMétodo HTTPPlano
60 Requisições1 horaGETPro, Advanced

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 horaGETAdvanced

Limite de requisições para consultar estatísticas do funil de vendas

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

Limite de requisições para consultar estatísticas dos ativos de conversão

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



Limite de requisições para consultar os fluxos de automação.

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

Limite de requisições para consultar os dados de um fluxo de automação a partir de um id.

Limite máximoPeríodoMétodo HTTPPlano
1 Requisição1 horaGETLight, Basic
5 Requisições1 horaGETPro
15 Requisições1 horaGETAdvanced

Limite de requisições para inserir leads em um fluxo de automação.

Limite máximoPeríodoMétodo HTTPPlano
1 Requisição1 horaPOSTLight, Basic
10 Requisições1 horaPOSTPro
100 Requisições1 horaPOSTAdvanced

Limite de requisições para consultar os leads que iniciaram em um fluxo de automação.

Limite máximoPeríodoMétodo HTTPPlano
1 Requisição1 horaGETLight, Basic
3 Requisições1 horaGETPro
12 Requisições1 horaGETAdvanced

Limite de requisições para consultar os leads que encerraram em um fluxo de automação.

Limite máximoPeríodoMétodo HTTPPlano
1 Requisição1 horaGETLight, Basic
3 Requisições1 horaGETPro
12 Requisições1 horaGETAdvanced

Limite de requisições para consultar os leads que atingiram uma ação específica de um fluxo de automação.

Limite máximoPeríodoMétodo HTTPPlano
1 Requisição1 horaGETLight, Basic
3 Requisições1 horaGETPro
12 Requisições1 horaGETAdvanced



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



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



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



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

Erro: 429 "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 que foram apresentados acima, 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)

Erro: 414 "URI Too Long"

Ao projetar seu aplicativo pense em controlar o tamanho da URL para não passar do limite de 8kb. Caso a URL passe do limite de 8kb de tamanho, você receberá um erro 414 URI Too Long.

👍

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.