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.