Premium proxy client for .NET with BrightData integration. Access residential, datacenter, ISP, and mobile proxies with geo-targeting, session management, and automatic rotation. Perfect for web scraping, data collection, ad verification, and social media automation.
Premium proxy client for .NET with BrightData integration. Access residential, datacenter, ISP, and mobile proxies with geo-targeting, session management, and automatic rotation.
Features
Multiple Proxy Types: Residential, Datacenter, ISP, and Mobile proxies
Geo-Targeting: Target by country, state, and city
Session Management: Sticky sessions for maintaining the same IP
Protocol Support: HTTP and SOCKS5 protocols
Easy Integration: Works with HttpClient, WebProxy, and dependency injection
Connection Testing: Built-in proxy testing and validation
Getting Your BrightData Credentials
This package requires a BrightData account. Choose the proxy type that best fits your needs:
using ForeverTools.Proxy;
// Create client with credentials
var client = new BrightDataClient("your-customer-id", "your-zone", "your-password");
// Make a request through the proxy
var html = await client.GetAsync("https://example.com");
// Or create an HttpClient for more control
using var httpClient = client.CreateHttpClient();
var response = await httpClient.GetAsync("https://example.com");
Using Environment Variables
// Set environment variables:
// BRIGHTDATA_CUSTOMER_ID, BRIGHTDATA_ZONE, BRIGHTDATA_PASSWORD
var client = BrightDataClient.FromEnvironment();
Geo-Targeting
Target by Country
// Get content as if from the US
var usContent = await client.GetFromCountryAsync("https://example.com", "us");
// Create an HttpClient for a specific country
using var ukClient = client.CreateHttpClientForCountry("gb");
Target by City
using ForeverTools.Proxy;
// Target specific city
var geoTarget = new GeoTarget
{
Country = "us",
State = "ny",
City = "new_york"
};
using var nyClient = client.CreateHttpClient(geoTarget);
var content = await nyClient.GetStringAsync("https://example.com");
Using Predefined Locations
// Common locations are predefined for convenience
var usClient = client.CreateHttpClient(GeoTarget.Locations.UnitedStates);
var ukClient = client.CreateHttpClient(GeoTarget.Locations.UnitedKingdom);
var deClient = client.CreateHttpClient(GeoTarget.Locations.Germany);
var jpClient = client.CreateHttpClient(GeoTarget.Locations.Japan);
Proxy Types
Residential Proxies
Best for general web scraping and geo-targeting. Uses real residential IPs.
using var httpClient = client.CreateResidentialHttpClient();
// or with geo-targeting
using var usClient = client.CreateResidentialHttpClient(GeoTarget.ForCountry("us"));
Datacenter Proxies
Best for high-speed scraping and bulk requests.
using var httpClient = client.CreateDatacenterHttpClient();
ISP Proxies
Best for long sessions and account management. Combines residential trust with datacenter speed.
using var httpClient = client.CreateISPHttpClient();
Mobile Proxies
Best for mobile-specific content and social media.
using var httpClient = client.CreateMobileHttpClient();
Session Management
Maintain the same IP address across multiple requests using sessions:
// Create a session (same IP for up to 5 minutes)
using var session = client.CreateSession();
// All requests use the same IP
using var httpClient = session.CreateHttpClient();
await httpClient.GetAsync("https://example.com/page1");
await httpClient.GetAsync("https://example.com/page2");
await httpClient.GetAsync("https://example.com/page3");
// Check session validity
Console.WriteLine($"Session age: {session.Age}");
Console.WriteLine($"Still valid: {session.IsValid}");
Session with Geo-Targeting
// Create a session from a specific location
using var session = client.CreateSession(GeoTarget.ForCountry("de"));
Testing Your Proxy
// Test the proxy connection
var result = await client.TestProxyAsync();
if (result.Success)
{
Console.WriteLine($"Proxy working!");
Console.WriteLine($"External IP: {result.ExternalIp}");
Console.WriteLine($"Country: {result.Country}");
Console.WriteLine($"City: {result.City}");
Console.WriteLine($"Response time: {result.ResponseTimeMs}ms");
}
else
{
Console.WriteLine($"Proxy failed: {result.Error}");
}
Test Multiple Countries
var countries = new[] { "us", "gb", "de", "jp", "au" };
var results = await client.TestMultipleCountriesAsync(countries);
foreach (var result in results)
{
Console.WriteLine($"{result.Country}: {(result.Success ? result.ExternalIp : result.Error)}");
}
Dependency Injection
Basic Registration
// In Program.cs or Startup.cs
services.AddForeverToolsProxy("customer-id", "zone", "password");
// Inject and use
public class MyService
{
private readonly BrightDataClient _proxyClient;
public MyService(BrightDataClient proxyClient)
{
_proxyClient = proxyClient;
}
public async Task DoWorkAsync()
{
var content = await _proxyClient.GetAsync("https://example.com");
}
}
// Register a named HttpClient with proxy
services.AddBrightDataHttpClient(
"ProxiedClient",
"customer-id",
"zone",
"password"
);
// Use via IHttpClientFactory
public class MyService
{
private readonly IHttpClientFactory _factory;
public MyService(IHttpClientFactory factory)
{
_factory = factory;
}
public async Task DoWorkAsync()
{
var client = _factory.CreateClient("ProxiedClient");
var response = await client.GetAsync("https://example.com");
}
}
Working with WebProxy
If you need a WebProxy instance for use with other libraries:
// Create a WebProxy
var webProxy = client.CreateWebProxy();
// Or with geo-targeting
var usProxy = client.CreateWebProxyForCountry("us");
// Use with any client that supports WebProxy
var handler = new HttpClientHandler { Proxy = webProxy, UseProxy = true };
Getting Raw Credentials
Access the raw proxy credentials for custom integrations:
var credentials = client.GetCredentials();
Console.WriteLine($"Host: {credentials.Host}");
Console.WriteLine($"Port: {credentials.Port}");
Console.WriteLine($"Username: {credentials.Username}");
Console.WriteLine($"Password: {credentials.Password}");
Console.WriteLine($"Proxy URL: {credentials.ProxyUrl}");
// Generate a curl command for testing
Console.WriteLine(credentials.ToCurlCommand("https://httpbin.org/ip"));
Configuration Options
var options = new ProxyOptions
{
CustomerId = "your-customer-id",
Zone = "your-zone",
Password = "your-password",
// Defaults
DefaultProxyType = ProxyType.Residential,
DefaultProtocol = ProxyProtocol.Http,
DefaultCountry = "us",
DefaultCity = null,
DefaultState = null,
TimeoutSeconds = 60,
Host = "brd.superproxy.io"
};
var client = new BrightDataClient(options);
