> ## Documentation Index
> Fetch the complete documentation index at: https://student-213fb9fc.mintlify.site/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                     | Sim                       |
| BR           | Brasil                 | Sim                     | Não                       |
| CA           | Canadá                 | Sim                     | Não                       |
| CN           | China                  | Sim                     | Não                       |
| CZ           | Tchéquia               | Sim                     | Não                       |
| DE           | Alemanha               | 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                       |
| HU           | Hungria                | Sim                     | Não                       |
| ID           | Indonésia              | 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                       |
| MY           | Malásia                | Sim                     | Não                       |
| NO           | Noruega                | Sim                     | Não                       |
| PL           | Polônia                | Sim                     | Não                       |
| PT           | Portugal               | Sim                     | Não                       |
| QA           | Catar                  | Sim                     | Não                       |
| SG           | Singapura              | Sim                     | Não                       |
| TR           | Turquia                | Sim                     | Não                       |
| US           | Estados Unidos         | Sim                     | Sim                       |
| VN           | Vietnã                 | Sim                     | Não                       |

<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 no Brasil, defina `location.country` como `BR`.

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(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 '@mendable/firecrawl-js';

  const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

  const doc = await firecrawl.scrape('https://example.com', {
    formatos: ['markdown'],
    localização: { país: 'US', idiomas: ['en'] },
  });

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

  ```bash cURL theme={null}
  curl -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com",
      "formatos": ["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>

<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).