Proxies

Route requests through specific geographic locations

Proxies let you route TinyFish Web Agent’s browser requests through specific countries. Use them to access geo-restricted content or avoid regional blocks.

How to Use

Add proxy_config to your request:

{
  url: "https://example.com",
  goal: "Extract product data",
  proxy_config: {
    enabled: true,
    country_code: "US"
  }
}

---

Supported Countries

Code	Country
US	United States
GB	United Kingdom
CA	Canada
DE	Germany
FR	France
JP	Japan
AU	Australia

---

When to Use Proxies

• Accessing geo-restricted content
• Avoiding regional IP blocks
• Testing localized content
• Combining with stealth mode for protected sites

---

Combining with Stealth Mode

For sites with bot protection and geo-restrictions, use both:

{
  url: "https://protected-site.com",
  goal: "Extract product data",
  browser_profile: "stealth",
  proxy_config: {
    enabled: true,
    country_code: "US"
  }
}

Learn more about browser profiles in the Browser Profiles page.

---

Related

Browser Profiles

Standard vs stealth browser modes

Endpoints

Choose how to call the API

Anti-Bot Guide

Diagnose and bypass bot detection on protected websites