# Proxies (/pt-BR/features/proxies)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1846 · updated: 2026-07-30 -->
Related: [Busca](/pt-BR/features/search.md), [Destaques da Busca](/pt-BR/features/search-highlights.md), [Índice de research](/pt-BR/features/research.md), [Scraping](/pt-BR/features/scrape.md), [Raspagem mais rápida](/pt-BR/features/fast-scraping.md), [Raspagem em lote](/pt-BR/features/batch-scrape.md)

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 [#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 [#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>
  <CodeBlockTabs defaultValue="Python" groupId="curl+node+python">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="Python">
        Python
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="Node">
        Node
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="cURL">
        cURL
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="Python">
      ```python  
      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)
      ```
    </CodeBlockTab>

    <CodeBlockTab value="Node">
      ```js  
      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);
      ```
    </CodeBlockTab>

    <CodeBlockTab value="cURL">
      ```bash  
      # 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"] }
        }'
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</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 [#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.
