429. Consulte Erros para ver o catálogo completo de erros e um snippet de repetição com backoff.
Limites de navegadores concorrentes
“Navegadores concorrentes” controlam quantas páginas o Firecrawl pode processar para você em paralelo. Seu plano define o limite; quaisquer jobs além dele aguardam em uma fila até que um navegador fique disponível. O tempo gasto na fila é contabilizado no parâmetrotimeout da requisição, portanto você pode definir um timeout menor para falhar mais rápido em vez de esperar. Para ver a disponibilidade atual antes de enviar trabalho, chame o endpoint Queue Status. Jobs que estiverem aguardando na sua fila de concorrência expirarão em no máximo 48 horas.
Planos atuais
| Plano | Navegadores concorrentes | Máximo de jobs na fila |
|---|---|---|
| Free | 2 | 50,000 |
| Hobby | 5 | 50,000 |
| Standard | 25 | 50,000 |
| Growth | 50 | 100,000 |
| Scale / Enterprise | 100+ | 200,000+ |
429 até que os jobs existentes sejam concluídos. Para planos maiores com limites de concorrência personalizados, o máximo de jobs na fila é 2.000 vezes o seu limite de concorrência, com teto de 2.000.000.
Se você precisar de limites de concorrência mais altos, entre em contato conosco sobre os planos Enterprise.
Limites de Taxa da API
Os limites de taxa são medidos em solicitações por minuto e existem principalmente para prevenir abusos. Quando tudo estiver configurado corretamente, o seu verdadeiro gargalo será o número de navegadores concorrentes. Os limites de taxa são aplicados por equipe, então todas as chaves de API da mesma equipe compartilham os mesmos contadores de limite de taxa.Sem chave (sem chave de API)
O endpoint sem chave do MCP hospedado do Firecrawl disponibiliza apenas Busca, Scraping e Parse sem uma chave de API. Outras ferramentas do MCP hospedado exigem uma conexão de conta ou uma chave de API. Para clientes oficiais do Firecrawl, a CLI, os SDKs e a API REST, o acesso sem chave também inclui Interagir. No Firecrawl Cloud, endpoints de research e de busca para desenvolvedores também podem ser usados sem uma chave de API. Nenhum outro endpoint (crawl, extract, map, batch scrape etc.) está disponível sem uma chave. O uso sem chave é gratuito e tem dois limites diários por endereço IP; se qualquer um deles for excedido, a API retorna429:
- Um número máximo de requisições por dia.
- Um número máximo de créditos por dia. As operações consomem quantidades diferentes de créditos (por exemplo, interação e extração JSON custam mais do que um scraping básico), então usos mais intensos atingem o limite de créditos mais rápido.
Planos atuais
| Plano | /scrape | /map | /crawl | /search | /agent | /crawl/status | /agent/status |
|---|---|---|---|---|---|---|---|
| Free | 10 | 10 | 2 | 10 | 2 | 500 | 500 |
| Hobby | 100 | 100 | 20 | 100 | 20 | 5000 | 5000 |
| Standard | 500 | 500 | 100 | 500 | 100 | 25000 | 25000 |
| Growth | 5000 | 5000 | 1000 | 5000 | 1000 | 250000 | 250000 |
| Scale | 10000 | 10000 | 2000 | 10000 | 2000 | 500000 | 500000 |
Endpoints de extração
Os endpoints de extração compartilham os mesmos rate limits dos endpoints /agent correspondentes.Endpoints de Batch Scrape
Os endpoints de batch scrape compartilham os mesmos limites de taxa dos endpoints /crawl correspondentes.Sandbox do navegador
Os endpoints do sandbox do navegador têm limites de taxa por plano, que variam de acordo com a sua assinatura:| Plano | /interact | /interact/{id}/execute |
|---|---|---|
| Free | 2 | 10 |
| Hobby | 20 | 100 |
| Standard | 100 | 500 |
| Growth | 1,000 | 5,000 |
| Scale | 1,500 | 7,500 |
429 até que as sessões existentes sejam encerradas.