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áximo | Período | Método HTTP | Plano |
---|---|---|---|
24 Requisições | 24 horas | PATCH | Light, Basic, Pro, Advanced |
Limite de requisições por conta
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
120 Requisições | 1 Minuto | GET, POST, PATCH, DELETE | Light, Basic, Pro |
500 Requisições | 1 Minuto | GET, POST, PATCH, DELETE | Advanced |
Limite de requisições por contato/lead
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
24 Requisições | 24 horas | POST | Light, Basic, Pro, Advanced |
Limite de requisições por conta
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
15.000 Requisições | 1 dia | POST | Light, Basic, Pro, Advanced |
Limite de requisições da lista de segmentações
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
120 Requisições | 1 minuto | GET | Light, Basic, Pro |
240 Requisições | 1 minuto | GET | Advanced |
Limite de requisições do lead
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
24 Requisições | 24 horas | GET, PUT | Light, Basic, Pro, Advanced |
Limite de requisições por conta
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1.000.000 Requisições | 24 horas | GET, PUT | Light, Basic, Pro, Advanced |
Limite de requisições por conta
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1.000.000 Requisições | 24 horas | GET, POST, PATCH, DELETE | Light, Basic, Pro, Advanced |
Limite de requisições por conta
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1.000.000 Requisições | 24 horas | GET, POST, PUT, DELETE | Light, Basic, Pro, Advanced |
Limite de requisições por lead
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
120 Requisições | 24 horas | POST | Light, Basic, Pro, Advanced |
Limite de requisições por conta
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
120 Requisições | 1 minuto | POST | Light, Basic, Pro |
500 Requisições | 1 minuto | POST | Advanced |
Limite de requisições para consultar estatísticas de e-mail marketing
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Pro, Advanced |
Limite de requisições para consultar estatísticas de e-mail via fluxo de automação
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Advanced |
Limite de requisições para consultar estatísticas do funil de vendas
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Advanced |
Limite de requisições para consultar estatísticas dos ativos de conversão
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Advanced |
Limite de requisições para consultar os fluxos de automação.
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
40 Requisições | 1 hora | GET | Light, Basic, Pro, Advanced |
Limite de requisições para consultar os dados de um fluxo de automação a partir de um id.
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1 Requisição | 1 hora | GET | Light, Basic |
5 Requisições | 1 hora | GET | Pro |
15 Requisições | 1 hora | GET | Advanced |
Limite de requisições para inserir leads em um fluxo de automação.
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1 Requisição | 1 hora | POST | Light, Basic |
10 Requisições | 1 hora | POST | Pro |
100 Requisições | 1 hora | POST | Advanced |
Limite de requisições para consultar os leads que iniciaram em um fluxo de automação.
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1 Requisição | 1 hora | GET | Light, Basic |
3 Requisições | 1 hora | GET | Pro |
12 Requisições | 1 hora | GET | Advanced |
Limite de requisições para consultar os leads que encerraram em um fluxo de automação.
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1 Requisição | 1 hora | GET | Light, Basic |
3 Requisições | 1 hora | GET | Pro |
12 Requisições | 1 hora | GET | Advanced |
Limite de requisições para consultar os leads que atingiram uma ação específica de um fluxo de automação.
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
1 Requisição | 1 hora | GET | Light, Basic |
3 Requisições | 1 hora | GET | Pro |
12 Requisições | 1 hora | GET | Advanced |
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Light, Basic, Pro, Advanced |
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Light, Basic, Pro, Advanced |
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Light, Basic, Pro, Advanced |
Limite máximo | Período | Método HTTP | Plano |
---|---|---|---|
60 Requisições | 1 hora | GET | Light, 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.