Proxies

Firecrawl provides different proxy types to help you scrape websites with varying levels of complexity. The proxy type can be specified using the proxy parameter.

By default, Firecrawl routes all requests through proxies to help ensure reliability and access, even if you do not specify a proxy type or location.

Location-Based Proxy Selection

Firecrawl automatically selects the best proxy based on your specified or detected location. This helps optimize scraping performance and reliability. However, not all locations are currently supported. The following locations are available:

| Country Code | Country Name | Basic Proxy Support | Enhanced Proxy Support | |--------------|----------------------|---------------------|------------------------| | AE | United Arab Emirates | Yes | No | | AU | Australia | Yes | No | | BR | Brazil | Yes | No | | CA | Canada | Yes | No | | CN | China | Yes | No | | DE | Germany | Yes | No | | DK | Denmark | Yes | No | | EE | Estonia | Yes | No | | EG | Egypt | Yes | No | | ES | Spain | Yes | No | | FR | France | Yes | No | | GB | United Kingdom | Yes | No | | GR | Greece | Yes | No | | IL | Israel | Yes | No | | IN | India | Yes | No | | IT | Italy | Yes | No | | JP | Japan | Yes | No | | NL | Netherlands | Yes | Yes | | PT | Portugal | Yes | No | | QA | Qatar | Yes | No | | TR | Turkey | Yes | No | | US | United States | Yes | Yes |

If you need proxies in a location not listed above, please contact us and let us know your requirements.

If you do not specify a proxy or location, Firecrawl will automatically use US proxies.

How to Specify Proxy Location

You can request a specific proxy location by setting the location.country parameter in your request. For example, to use a German proxy, set location.country to DE.

For full details, see the API reference for location.country.

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # No API key needed to get started — add one for higher rate limits:
  # api_key="fc-YOUR-API-KEY",
)

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

print(doc)

Proxy Types

Firecrawl supports three types of proxies:

• basic: Proxies for scraping most sites. Fast and usually works.
• enhanced: Enhanced proxies for scraping complex sites while maintaining privacy. Slower, but more reliable on certain sites. Learn more about Enhanced Mode →
• auto: Firecrawl will automatically retry scraping with enhanced proxies if the basic proxy fails. If the retry with enhanced is successful, 5 credits will be billed for the scrape. If the first attempt with basic is successful, only the regular cost will be billed.

Note: For detailed information on using enhanced proxies, including credit costs and retry strategies, see the Enhanced Mode documentation.

Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.