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, Enterprise

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, DELETEEnterprise

Limite de requisições por contato/lead

Limite máximoPeríodoMétodo HTTPPlano
24 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

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

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

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

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

Limite de requisições por conta

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

Limite de requisições por conta

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

Limite de requisições por 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

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

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

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

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

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

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

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

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

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

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

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)

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.