At a glance
How residential routing works
When you send a request through FlameProxies, the gateway selects an IP from the residential pool that matches your parameters (country or region, city, ASN, OS, pool, and mode). Your request is sent through that IP to the target website, and the response comes back to you. The target website sees the residential IP, not yours. Because these IPs are assigned by real ISPs to real households, most anti-bot systems treat them as legitimate traffic. You control which IPs are eligible with location and pool parameters, and how long you keep the same IP with session parameters.Session types
There are two ways to use residential proxies: rotating (new IP every request) and sticky sessions (the same IP across multiple requests).Rotating (no session)
When you don’t include asession parameter, every request gets a new IP. This is the simplest mode, and it works well for high-volume scraping where you don’t need IP continuity.
Sticky sessions (held IP)
When you include asession parameter, the gateway holds the same IP for every request with that session ID. Add time-<minutes> to cap how long it holds that IP.
- You choose the session ID. Use letters and digits, like
a1b2. Don’t use hyphens — they separate parameters. timeis optional. Add it to set how many minutes the session holds its IP:session-<id>-time-<minutes>.- To get a new IP before the time is up, use a new session ID.
- To run several sticky sessions in parallel, give each one its own session ID.
Geo-targeting
You can target residential IPs by country, by region, or down to a city. These parameters limit which IPs are eligible for your requests.
Use
city together with country. Target either a country or a region, not both. For example, to target New York:
Region targeting
A region exits from a group of countries instead of one country. It’s a good middle ground when any country in an area works, and it leaves a much larger pool than a single country.
Each region is weighted toward its largest markets, so most traffic exits from the first few countries listed below.
eu · Europe · 30 countries
eu · Europe · 30 countries
Germany, United Kingdom, France, Italy, Spain, Netherlands, Poland, Sweden, Belgium, Austria, Switzerland, Portugal, Ireland, Denmark, Finland, Norway, Czech Republic, Romania, Greece, Hungary, Slovakia, Bulgaria, Croatia, Slovenia, Lithuania, Latvia, Estonia, Luxembourg, Cyprus, Malta.
na · North America · 3 countries
na · North America · 3 countries
United States, Canada, Mexico.
t1 · Tier 1 · 15 countries
t1 · Tier 1 · 15 countries
United States, United Kingdom, Germany, Canada, France, Australia, Netherlands, Switzerland, Sweden, Ireland, Norway, Denmark, Belgium, Austria, New Zealand.
asia · Asia · 21 countries
asia · Asia · 21 countries
Japan, South Korea, India, Singapore, Indonesia, Thailand, Vietnam, Philippines, Malaysia, Hong Kong, Taiwan, Pakistan, Bangladesh, China, Sri Lanka, Nepal, Cambodia, Macau, Mongolia, Laos, Brunei.
latam · Latin America · 19 countries
latam · Latin America · 19 countries
Brazil, Mexico, Argentina, Colombia, Chile, Peru, Ecuador, Venezuela, Dominican Republic, Guatemala, Uruguay, Paraguay, Bolivia, Costa Rica, Panama, Honduras, El Salvador, Nicaragua, Puerto Rico.
ASN targeting
Target the IPs of one network operator with its autonomous system number.org field in the response to confirm which network the IP belongs to. Add a session to hold one IP across requests:
OS targeting
Target IPs whose device runs a particular operating system.Region, ASN, and OS targeting are available on residential proxies (
package-standard) only. Premium residential supports country and city targeting.Pools
The residential network is split into sub-pools with different performance characteristics. By default, the gateway draws from the whole network.
If a target performs poorly, try each pool and compare success rates and speed.
Modes
Modes change how the gateway handles your connection. You can combine them.
Example: fast mode in the United States:
Full parameter reference
Here’s every parameter available for residential proxies:
Username format:
Example configurations
Basic rotating proxy, United States:Limits
Next steps
Premium residential proxies
Clean, high-trust IPs for strict anti-bot targets.
Locations
Every country and city you can target.
Authentication
Credentials, protocols, and output formats.
Python examples
Working Python code for residential proxies.
