Enhanced Mode | Evocrawl

Evocrawl provides different proxy types to help you scrape websites with varying levels of complexity. Set the proxy parameter to control which proxy strategy is used for a request.

Proxy types

Evocrawl supports three proxy types:

Type	Description	Speed	Cost
`basic`	Standard proxies suitable for most sites	Fast	1 credit
`enhanced`	Enhanced proxies for complex sites	Slower	5 credits per request
`auto`	Tries `basic` first, then retries with `enhanced` on failure	Varies	1 credit if basic succeeds, 5 credits if enhanced is needed

If you do not specify a proxy, Evocrawl defaults to auto.

Basic usage

Set the proxy parameter to choose a proxy strategy. The following example uses auto, which lets Evocrawl decide when to escalate to enhanced proxies.

from evocrawl import Evocrawl

evocrawl = Evocrawl(api_key='fc-YOUR-API-KEY', api_base='https://api.evocrawl.com')

# Choose proxy strategy: 'basic' | 'enhanced' | 'auto'
doc = evocrawl.scrape('https://example.com', formats=['markdown'], proxy='auto')

print(doc.warning or 'ok')

import Evocrawl from '@mendable/evocrawl-js';

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

// Choose proxy strategy: 'basic' | 'enhanced' | 'auto'
const doc = await evocrawl.scrape('https://example.com', {
  formats: ['markdown'],
  proxy: 'auto'
});

console.log(doc.warning || 'ok');

// Choose proxy strategy: 'basic' | 'enhanced' | 'auto'
curl -X POST https://api.evocrawl.com/v2/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer fc-YOUR-API-KEY' \
    -d '{
      "url": "https://example.com",
      "proxy": "auto"
    }'

Enhanced proxy requests cost 5 credits per request. When using auto, the 5-credit cost only applies if the basic proxy fails and the enhanced retry succeeds.

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