# Cobrança
> Como funcionam cobrança, créditos e planos do Firecrawl
## Visão geral
A cobrança do Firecrawl é **baseada em créditos**. Cada chamada de API que você faz consome créditos. A quantidade de créditos depende do endpoint e das opções que você utiliza. Seu plano oferece uma cota mensal de créditos. O pagamento por uso adiciona mais créditos quando a cota se esgota.
Para ver os preços atuais dos planos, visite a [página de preços do Firecrawl](https://www.firecrawl.dev/pricing).
Todas as faturas do Firecrawl são emitidas em **dólares americanos (USD)**, independentemente do seu endereço de cobrança ou método de pagamento.
## Créditos
Créditos são a unidade de consumo no Firecrawl. Cada plano inclui uma cota mensal de créditos que é renovada no início de cada ciclo de cobrança. Diferentes endpoints da API consomem quantidades diferentes de créditos.
### Custos de crédito por endpoint
| Endpoint | custo em crédito | Observações |
| ------------ | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Scrape** | 1 crédito / página | Converte uma única URL em markdown limpo, HTML ou dados estruturados. Créditos adicionais se aplicam ao usar opções de scraping (consulte abaixo). |
| **rastreamento** | 1 crédito / página | Faz o scraping de um site inteiro seguindo links a partir de uma URL inicial. Os mesmos custos das opções de scraping por página se aplicam a cada página rastreada. |
| **Map** | 1 crédito / chamada | Descobre todas as URLs em um site sem fazer scraping do conteúdo. |
| **Search** | 2 créditos / 10 resultados | Faz uma busca na web e, opcionalmente, realiza o scraping dos resultados. Arredondado para cima a cada 10 resultados (por exemplo, 11 resultados = 4 créditos). Custos adicionais de scraping por página se aplicam a cada resultado que for raspado. Consulte [aqui](/pt-BR/features/search#zero-data-retention-zdr) para ver os preços da busca ZDR Enterprise. |
| **Interact** | 2–7 créditos / minuto de navegador | Sessão interativa de sandbox de navegador, cobrada por minuto de navegador, com mínimo de um minuto. Sessões que usam um `prompt` são cobradas a 7 créditos / minuto de navegador; sessões sem prompt (somente `code` do Playwright) são cobradas a 2 créditos / minuto de navegador. |
| **Agent** | Dinâmico | Agente autônomo de pesquisa na web. 5 execuções diárias gratuitas; cobrança baseada em uso após isso. |
### Custos adicionais de crédito para opções de scraping
Certas opções de scraping adicionam créditos além do custo base por página:
| Opção | Custo adicional | Descrição |
| -------------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PDF parsing | +1 crédito / página de PDF | Extrair conteúdo de documentos PDF |
| formato JSON (extração com LLM) | +4 créditos / página | Usar um LLM para extrair dados JSON estruturados da página |
| Verificação de injeção de prompt | +4 créditos / página | Proteção opcional `checkPromptInjection` para formato JSON (veja [Detecção de injeção de prompt](/pt-BR/features/llm-extract#prompt-injection-detection)). Se o scraping falhar após a execução da verificação, serão cobrados 5 créditos em vez dos 0 habituais para um scraping com falha. Isso inclui um scraping bloqueado com um 403 porque uma injeção foi detectada. |
| sem retenção de dados (ZDR) | +1 crédito / página | Garante que nenhum dado seja persistido além da requisição (veja [Scrape ZDR](/pt-BR/features/scrape#zero-data-retention-zdr)) |
Esses modificadores se acumulam. Por exemplo, fazer scraping de uma página com formato JSON e sem retenção de dados custa **1 + 4 + 1 = 6 créditos** por página. Esses mesmos modificadores se aplicam aos endpoints rastreamento e Search, já que eles usam scraping internamente para cada página.
Requisições para `x.com` e outras URLs do X/Twitter usam a API do Grok e têm preços separados. Veja [cobrança do X (x.com)](#x-xcom-billing) no final desta página.
### Quando os créditos são debitados
Os créditos são debitados sempre que a infraestrutura do Firecrawl processa uma request, mesmo que o site de destino retorne um código de status de erro HTTP, como 403 Forbidden ou 404 Not Found. Isso acontece porque a infraestrutura de scraping (renderização no navegador, proxy etc.) é totalmente utilizada, independentemente da resposta do site de destino. Você pode verificar o campo `metadata.statusCode` na resposta da API para detectar esses casos e evitar tentar novamente URLs que são bloqueadas de forma consistente.
Para jobs de **batch scrape** e **rastreamento**, os créditos são debitados de forma assíncrona à medida que cada página conclui o processamento, não quando o job é submetido. Isso significa que pode haver um atraso entre a submissão de um job e ver o custo total de créditos refletido na sua conta. Se um batch contiver muitas URLs ou se as páginas forem enfileiradas durante períodos de alto tráfego, os créditos podem continuar aparecendo minutos ou horas após a submissão. Realizar polling ou verificar o status do batch não consome créditos.
**Verificação prévia de créditos do rastreamento:** Antes de um job de rastreamento começar, o Firecrawl verifica se o saldo de créditos restante é suficiente para cobrir todo o parâmetro `limit` solicitado. Se o seu saldo for menor que `limit`, a request retorna um 402 mesmo que o rastreamento tivesse descoberto menos páginas. O `limit` padrão é **10.000**, portanto omiti-lo exige que 10.000 créditos estejam disponíveis antecipadamente. Para evitar isso, passe um `limit` explícito que corresponda ao número de páginas que você realmente pretende rastrear (por exemplo, `limit: 100`).
### Monitorando seu uso
Você pode acompanhar o uso de créditos de duas maneiras:
* **Dashboard**: Veja seu uso atual e histórico em [firecrawl.dev/app](https://www.firecrawl.dev/app)
* **API**: Use os endpoints [Credit Usage](/pt-BR/api-reference/endpoint/credit-usage) e [Credit Usage Historical](/pt-BR/api-reference/endpoint/credit-usage-historical) para verificar seu uso programaticamente
Estamos trabalhando ativamente em melhorias para tornar o uso de créditos mais fácil de entender. Fique de olho nas próximas atualizações.
## Planos
Os planos de assinatura são cobrados mensalmente ou anualmente. Os planos pagos de autoatendimento também podem usar o pagamento por uso. O pagamento por uso adiciona créditos quando a franquia do seu plano se esgota. Consulte [Pagamento por uso](#auto-reload).
### Planos pagos
| Plano | Créditos mensais | Navegadores concorrentes |
| ------------ | --------------------------- | -----------------------: |
| **Hobby** | 5,000 / 6,500 / 8,000 | 5 |
| **Standard** | 100,000 / 130,000 / 160,000 | 25 |
| **Growth** | 500,000 / 650,000 | 50 |
| **Scale** | 1,000,000 | 100 |
Para necessidades além do plano Scale, Firecrawl oferece planos **Enterprise** com créditos personalizados, suporte dedicado, SLAs, descontos em volume, sem retenção de dados e SSO. Visite a [página Enterprise](https://www.firecrawl.dev/enterprise) para mais detalhes.
Todos os planos pagos estão disponíveis com cobrança **mensal** ou **anual**. A cobrança anual oferece um desconto em comparação ao pagamento mês a mês. Para preços atualizados de cada plano, visite a [página de preços](https://www.firecrawl.dev/pricing).
### Ciclo de cobrança
* **Planos mensais**: Os créditos são restaurados na sua data de renovação mensal
* **Planos anuais**: A cobrança é anual, mas os créditos ainda são restaurados todo mês na sua data de renovação mensal virtual
* **Créditos do plano não utilizados não são transferidos por padrão**: sua cota mensal é restaurada a cada mês. **Planos anuais Scale transferem créditos do plano não utilizados por 1 mês**, e **planos anuais Enterprise os transferem por 2 meses**.
### Navegadores simultâneos
Navegadores simultâneos representam quantas páginas da web o Firecrawl pode processar para você ao mesmo tempo. Seu plano determina esse limite. Se você o exceder, tarefas adicionais ficam em uma fila de espera até que uma vaga seja liberada. Consulte [Limites de Taxa](/pt-BR/rate-limits) para ver todos os detalhes sobre concorrência e limites de taxa da API.
## Pagamento por uso {#auto-reload}
O pagamento por uso mantém suas solicitações em execução quando os créditos do seu plano se esgotam. Ele adiciona créditos à sua conta automaticamente.
Você compra créditos em incrementos de US$ 5. Quando seu saldo de créditos chega a zero, adicionamos um incremento à sua conta e cobramos o cartão cadastrado.
O pagamento por uso exige um plano pago de autoatendimento. Não é possível usar o pagamento por uso no plano gratuito.
Você também pode comprar créditos a qualquer momento. Use **Carregar mais créditos** nas [configurações de cobrança](https://www.firecrawl.dev/app/settings?tab=billing). Insira um múltiplo de US$ 5 e pague com o cartão cadastrado. Isso funciona independentemente de o pagamento por uso estar ativado ou desativado.
### Créditos por incremento {#credits-in-a-batch}
A quantidade de créditos por incremento depende do seu plano. O pagamento por uso e as compras manuais usam a mesma taxa.
| Plano | Créditos por US$ 5 |
| ------------ | ------------------ |
| **Hobby** | 1.000 |
| **Standard** | 2.000 |
| **Growth** | 2.500 |
| **Scale** | 5.000 |
### Defina o limite mensal de pagamento por uso {#set-the-monthly-auto-reload-limit}
Defina seu **Limite mensal de pagamento por uso** em um destes dois locais:
* Nas suas [configurações de cobrança](https://www.firecrawl.dev/app/settings?tab=billing), na aba **Cobrança**.
* Na [página de preços](https://www.firecrawl.dev/pricing), ao escolher um plano.
### Como o limite restringe seus gastos mensais
Seu limite é o valor máximo que o pagamento por uso pode gastar em um mês. Ele é arredondado para baixo para incrementos inteiros de 5 USD.
Por exemplo, um limite de 25 USD permite cinco incrementos por mês. Um limite de 22 USD permite quatro incrementos, pois é arredondado para baixo para 20 USD.
Os créditos comprados manualmente não contam para esse limite.
## Upgrades e downgrades de plano
* **Upgrades** entram em vigor imediatamente. O valor integral do novo plano é cobrado hoje (sem cobrança proporcional), e seu ciclo de cobrança é reiniciado. Sua próxima renovação será em um mês ou um ano a partir da data do upgrade. Quaisquer créditos não utilizados do seu plano anterior são transferidos, e sua nova franquia de créditos e limites de concorrência se aplicam na hora.
* **Downgrades** são agendados para entrar em vigor na sua próxima data de renovação. Você mantém os créditos e limites do seu plano atual até lá, e o tempo não utilizado do seu plano atual não gera créditos nem reembolso. Você pode desfazer um downgrade agendado nas suas [configurações de cobrança](https://www.firecrawl.dev/app/settings?tab=billing) a qualquer momento antes da data de vigência.
### Alternar entre cobrança mensal e anual
* **Mensal → Anual** no mesmo nível de créditos ou em um nível superior é considerado um upgrade imediato.
* **Anual → Mensal** é considerado um upgrade imediato apenas se você mudar para um nível de créditos estritamente superior.
## Créditos esgotados
Se seus créditos acabarem e o pagamento por uso estiver desativado, as solicitações que consomem créditos retornarão um erro **HTTP 402 (Pagamento Necessário)**.
Se o pagamento por uso estiver ativado, adicionamos um novo incremento de créditos de US$ 5 quando seu saldo chega a zero. Suas solicitações continuam normalmente.
Para retomar o uso após uma interrupção, você pode:
1. Definir um **Limite mensal de pagamento por uso** para comprar créditos automaticamente. Consulte [Pagamento por uso](#auto-reload).
2. Fazer upgrade manualmente para um plano superior
3. Aguardar a redefinição dos seus créditos no próximo ciclo de cobrança
## Cupons
A Firecrawl oferece dois tipos de cupons:
* **Cupons de assinatura** aplicam um desconto à assinatura do seu plano (por exemplo, uma porcentagem de desconto no valor mensal ou anual). Eles **só** podem ser aplicados durante o fluxo de checkout do Stripe, quando você assina um plano pago pela primeira vez ou muda de plano. Não é possível aplicar um cupom de assinatura depois que o checkout for concluído.
* **Cupons de crédito** adicionam créditos bônus à sua conta. Eles podem ser resgatados na seção **cobrança** do seu painel em [firecrawl.dev/app/billing](https://www.firecrawl.dev/app/billing). Procure o campo de cupom na página de cobrança para aplicar seu código. Os créditos bônus de cupons de crédito são separados da cota mensal do seu plano e permanecem mesmo se você fizer upgrade ou downgrade do seu plano.
## Perguntas frequentes
**Créditos do plano** não são transferidos por padrão: sua cota mensal é redefinida a cada mês. **Planos anuais Scale transferem créditos do plano não utilizados por 1 mês**, e **planos anuais Enterprise os transferem por 2 meses**.
Os créditos que você compra permanecem na sua conta até que você os utilize. Eles expiram se você cancelar sua assinatura, então use-os antes de sair. A expiração ocorre no fim do seu período de cobrança atual, e uma renovação não os afeta.
Seu limite restringe quanto o pagamento por uso gasta a cada mês. Ele é arredondado para baixo em incrementos inteiros de 5 USD. Um limite de 25 USD permite cinco incrementos por mês. Deixe seu limite em branco, e o pagamento por uso não terá limite mensal. Defina seu limite como `0`, e o pagamento por uso será desativado.
Verifique o painel em [firecrawl.dev/app](https://www.firecrawl.dev/app), ou acesse o [endpoint da API de Credit Usage](/pt-BR/api-reference/endpoint/credit-usage) programaticamente.
Depende do tipo de cupom. Aplique um **cupom de crédito** na seção cobrança do seu painel. Você pode aplicar um **cupom de assinatura** (um desconto no preço do seu plano) apenas na página de checkout do Stripe, ao assinar ou mudar de plano.
Entre em contato pelo e-mail [help@firecrawl.dev](mailto:help@firecrawl.dev), ou visite a [página Enterprise](https://www.firecrawl.dev/enterprise) para saber mais sobre planos personalizados.
Todas as faturas do Firecrawl são cobradas em **dólares americanos (USD)**, independentemente do seu endereço de cobrança ou método de pagamento.
Acesse suas [configurações de cobrança](https://www.firecrawl.dev/app/settings?tab=billing). Administradores da equipe podem gerenciar tudo lá. Clique em **Manage Subscription** para abrir o portal de cobrança e atualizar seu método de pagamento, endereço de cobrança, nome da empresa ou número de VAT.
Para mudar de plano, clique em **Change Plan** e escolha um novo nível. Os upgrades entram em vigor imediatamente. Os downgrades entram em vigor no fim do seu período de cobrança atual, e você pode desfazer um até lá. Veja [Upgrades e downgrades de plano](#upgrading-and-downgrading).
Para cancelar, clique em **Cancel Subscription**. Seu plano permanece ativo até o fim do seu período de cobrança atual, e você pode retomá-lo antes disso. Quando seu plano termina, os créditos que você comprou expiram junto com ele, então use-os antes de sair.
Acesse suas [configurações de cobrança](https://www.firecrawl.dev/app/settings?tab=billing), clique em **Manage Subscriptions** e atualize seu endereço de cobrança, nome da empresa e número de VAT no portal da Stripe. As próximas faturas incluirão automaticamente as informações atualizadas.
Para reemitir uma fatura paga anterior com as novas informações:
1. Atualize primeiro seus dados de cobrança no portal da Stripe (veja acima).
2. Abra a aba **Invoice history** no portal da Stripe e baixe o PDF da fatura desejada; a Stripe a renderiza novamente com base nas suas informações de cobrança atuais.
3. Se alguma fatura não refletir os dados atualizados, envie um e-mail para [help@firecrawl.dev](mailto:help@firecrawl.dev) com os números das faturas e nós as reemitiremos para você.
## Cobrança do X (x.com)
O Firecrawl usa a **API oficial do Grok** da [xAI](https://x.ai/) para oferecer resumos com IA, extração estruturada e acesso em tempo real a conteúdo público do X. As requisições para URLs de perfis e publicações de `x.com`, `twitter.com` e `mobile.twitter.com` são processadas por meio das ferramentas internas autorizadas do Grok (`x_search`, obtenção de threads e busca na web restrita a x.com), em vez do scraping tradicional da web.
### Custos em créditos
| Componente | Custo em créditos | Descrição |
| ---------------- | ------------------------- | ----------------------------------------------------------------------- |
| **Custo base** | 1 crédito / requisição | Processamento padrão de requisição de scraping |
| **Grok X Query** | +29 créditos / requisição | Uso da API do Grok (tokens + chamadas de ferramenta) para conteúdo do X |
Por exemplo, processar uma requisição típica de post ou thread custa **30 créditos** (`1` base + `29` Grok X Query) e retorna dados estruturados gerados pelo Grok, contexto da thread e resumos. Se o formato JSON (extração com LLM) também estiver habilitado, o total será de **34 créditos** por requisição.
Esse método está em conformidade com as interfaces publicadas pelo X por meio da parceria com a xAI e fornece resultados de maior qualidade e com raciocínio, em vez de fazer scraping bruto da página.
**Os recursos diferem do scraping padrão.** O Grok retorna resultados processados por IA, que podem incluir resumos, métricas importantes, contexto da thread e muito mais. Para dados estruturados brutos em escala, use a [API oficial X Enterprise](https://developer.x.com/).