Proxy Documentation

Usage examples

Practical examples demonstrating how to use the proxy product with different options. This includes sample commands and scripts using popular languages like Python, etc.


import urllib.request

proxy_user = "customer-USERNAME-cc-XX-city-YYYY-sessid-abcde12345-sesstime-ZZZZ"
proxy_pass = "PASSWORD"
proxy_host = "rs.magneticproxy.net"
proxy_port = "1080"

proxy_url = f"http://{proxy_user}:{proxy_pass}@{proxy_host}:{proxy_port}"

proxy_handler = urllib.request.ProxyHandler({
    "http": proxy_url,
    "https": proxy_url
})
opener = urllib.request.build_opener(proxy_handler)
urllib.request.install_opener(opener)

try:
    with urllib.request.urlopen("https://google.com") as response:
        body = response.read()
        print("Status code:", response.status)
        print("Body:", body.decode("utf-8"))
except Exception as e:
    print("Error:", e)

Python Variables

Host and port should be kept as are rs.magneticproxy.net and 80/1080, respectively. Then, you only need to update proxy_user and proxy_pass values.

Parameter	Description	Default Value	Example
proxy_user	Sets the user credentials for proxy access. Provided when a plan is purchased. In the username section custom options can be added. See Proxy Options.	None (mandatory)	`customer-USERNAME`
proxy_pass	Password for proxy authentication.	None (mandatory)	`PASSWORD`
proxy_host	Specifies the proxy server to use.	rs.magneticproxy.net	`rs.magneticproxy.net`
proxy_port	Proxy port.	1080 (HTTP), 80 (HTTP), 443 (HTTPS)	`80`

Options

Detailed explanation of the available proxy options, including their purpose and functionality. They are included in the username separated by - (hyphens) between the key and the value, and also between each key-value pair.

Parameter	Description	Default Value	Example
customer	Customer Username for proxy authentication. Will be provided by email once a subscription is done.	None (mandatory)	`customer-MyUserName`
cc	Country code of standard ISO 3166-1 alpha-2 for proxy location. If not specified, a proxy from any location will be used.	N/A	`cc-US`
city	City name for proxy location. No ISO standard, just the name. If not specified, a proxy from any location will be used.	N/A	`city-Miami`
sessid	Session identifier for proxy. AKA Sticky session ID. Alphanumeric that must be generated by the client and always be the same for the sticky session. Do not use hyphens when creating this identifier. When sessid is present, the same proxy IP will be maintained between all requests if possible. If the IP is not available, another from the same country will be provided. If there are no more IPs from that country, an IP from any country will be provided.	N/A	`sessid-abcde12345`
sesstime	Session duration for proxy authentication. If not specified, a default of 30 minutes will be used. Session time value is in seconds.	1800 (30 minutes)	`sesstime-60`
hardcountry	Operates in tandem with sessid. When enabled, in the event that the session ID's linked proxy isn't located, and no proxy from the same country is located either, it results in failure.	false	`hardcountry-true`

Restricted targets

Some websites are limited or blocked on our Residential Proxy network to avoid misuse and suspicious activities. The list includes but is not limited to:

Category	Examples	Restrictions / Notes
Social Media	LinkedIn, Instagram, X.com	Access is fully blocked; the proxy will return an error.
Government & Public	usa.gov, canada.ca, *.gov domains	Official or sensitive sites; usage is restricted.
Email Providers	Outlook, Yahoo Mail	Access is fully blocked; the proxy will return an error.
SOCKS Proxy	Port 25	Port 25 is closed by default.

If you have any question, get in touch with our customer support team at contact@magneticproxy.com or via the 24/7 live chat on our website.