> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxies

> Saiba mais sobre tipos de proxy, regiões e como o Firecrawl seleciona proxies para suas requisições.

A Firecrawl oferece diferentes tipos de proxy para ajudar você a fazer scraping de sites com diversos níveis de complexidade. O tipo de proxy pode ser especificado usando o parâmetro `proxy`.

> Por padrão, a Firecrawl roteia todas as requisições por meio de proxies para garantir confiabilidade e acesso, mesmo que você não especifique um tipo de proxy ou localização.

<div id="location-based-proxy-selection">
  ## Seleção de proxy por localização
</div>

O Firecrawl seleciona automaticamente o melhor proxy com base na sua localização especificada ou detectada. Isso ajuda a otimizar o desempenho e a confiabilidade da extração. No entanto, nem todas as localidades são atualmente compatíveis. As seguintes localidades estão disponíveis:

| Country Code | Nome do país           | Suporte básico de proxy | Suporte avançado de proxy |
| ------------ | ---------------------- | ----------------------- | ------------------------- |
| AE           | Emirados Árabes Unidos | Sim                     | Não                       |
| AU           | Austrália              | Sim                     | Não                       |
| BR           | Brasil                 | Sim                     | Não                       |
| CA           | Canadá                 | Sim                     | Não                       |
| CN           | China                  | Sim                     | Não                       |
| DE           | Alemanha               | Sim                     | Não                       |
| DK           | Dinamarca              | Sim                     | Não                       |
| EE           | Estônia                | Sim                     | Não                       |
| EG           | Egito                  | Sim                     | Não                       |
| ES           | Espanha                | Sim                     | Não                       |
| FR           | França                 | Sim                     | Não                       |
| GB           | Reino Unido            | Sim                     | Não                       |
| GR           | Grécia                 | Sim                     | Não                       |
| IL           | Israel                 | Sim                     | Não                       |
| IN           | Índia                  | Sim                     | Não                       |
| IT           | Itália                 | Sim                     | Não                       |
| JP           | Japão                  | Sim                     | Não                       |
| NL           | Países Baixos          | Sim                     | Sim                       |
| PT           | Portugal               | Sim                     | Não                       |
| QA           | Catar                  | Sim                     | Não                       |
| TR           | Turquia                | Sim                     | Não                       |
| US           | Estados Unidos         | Sim                     | Sim                       |

<Warning>A lista de locais de proxy compatíveis mudará ao longo do tempo.</Warning>

Se você precisar de proxies em uma localidade não listada acima, por favor [entre em contato conosco](mailto:help@firecrawl.com) e informe suas necessidades.

Se você não especificar um proxy ou uma localidade, o Firecrawl usará automaticamente proxies dos EUA.

<div id="how-to-specify-proxy-location">
  ## Como especificar a localização do proxy
</div>

Você pode solicitar uma localização específica de proxy definindo o parâmetro `location.country` na sua requisição. Por exemplo, para usar um proxy na Alemanha, defina `location.country` como `DE`.

Para ver todos os detalhes, consulte a [referência da API de `location.country`](https://docs.firecrawl.dev/api-reference/endpoint/scrape#body-location).

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # Nenhuma API key necessária para começar — adicione uma para limites de taxa maiores:
    # api_key="fc-YOUR-API-KEY",
  )

  doc = firecrawl.scrape('https://example.com',
      formats=['markdown'],
      location={
          'country': 'US',
          'languages': ['en']
      }
  )

  print(doc)
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const firecrawl = new Firecrawl({
    // Nenhuma API key necessária para começar — adicione uma para limites de taxa mais altos:
    // apiKey: "fc-YOUR-API-KEY",
  });

  const doc = await firecrawl.scrape('https://example.com', {
    formats: ['markdown'],
    location: { country: 'US', languages: ['en'] },
  });

  console.log(doc.metadata);
  ```

  ```bash cURL theme={null}
  # Não é necessária uma chave de API para começar — adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa maiores:
  curl -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com",
      "formats": ["markdown"],
      "location": { "country": "US", "languages": ["en"] }
    }'
  ```
</CodeGroup>

<Info>Se você solicitar um país onde não há proxy disponível, o Firecrawl usará a região disponível mais próxima (UE ou EUA) e definirá a localização do navegador para o país solicitado.</Info>

<Warning>Recomendamos fortemente deixar `location` sem especificar, a menos que você tenha certeza de que precisa disso.</Warning>

<div id="proxy-types">
  ## Tipos de Proxy
</div>

Firecrawl oferece suporte a três tipos de proxy:

* **basic**: Proxies para scraping da maioria dos sites. Rápidos e geralmente funcionam.
* **enhanced**: Proxies aprimorados para scraping de sites complexos mantendo a privacidade. Mais lentos, mas mais confiáveis em certos sites. [Saiba mais sobre o Enhanced Mode →](/pt-BR/features/enhanced-mode)
* **auto**: Firecrawl refará automaticamente o scraping usando proxies aprimorados se o proxy básico falhar. Se a nova tentativa com enhanced for bem-sucedida, 5 créditos serão cobrados pelo scraping. Se a primeira tentativa com basic for bem-sucedida, apenas o custo padrão será cobrado.

***

> **Observação:** Para informações detalhadas sobre o uso de proxies aprimorados, incluindo custos de créditos e estratégias de repetição de tentativas, consulte a [documentação do Enhanced Mode](/pt-BR/features/enhanced-mode).

> Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para obter instruções de onboarding automatizado.