Proxy Italy documentation

1. Quick Start

Inserisci le credenziali proxy nel tuo client e verifica l'IP in uscita.

curl -x http://USER:PASS@proxy.proxyitaly.com:10001 https://api.ipify.org

2. Credenziali

3. Protocolli

Supporto completo per HTTP e SOCKS5 sullo stesso host e porta.

4. Esempi di codice

curl

curl -x http://USER:PASS@proxy.proxyitaly.com:10001 https://api.ipify.org

Python requests

import requests

proxies = {
  "http": "http://USER:PASS@proxy.proxyitaly.com:10001",
  "https": "http://USER:PASS@proxy.proxyitaly.com:10001",
}

res = requests.get("https://api.ipify.org", proxies=proxies, timeout=30)
print(res.text)

Python httpx

import httpx

proxy = "http://USER:PASS@proxy.proxyitaly.com:10001"
with httpx.Client(proxy=proxy, timeout=30) as client:
    r = client.get("https://api.ipify.org")
    print(r.text)

Python Scrapy

# settings.py
DOWNLOADER_MIDDLEWARES = {
    "scrapy.downloadermiddlewares.httpproxy.HttpProxyMiddleware": 110,
}

HTTP_PROXY = "http://USER:PASS@proxy.proxyitaly.com:10001"
HTTPPROXY_ENABLED = True

Node.js axios

import axios from "axios";

const res = await axios.get("https://api.ipify.org", {
  proxy: {
    host: "proxy.proxyitaly.com",
    port: 10001,
    auth: { username: "USER", password: "PASS" },
  },
});
console.log(res.data);

Node.js fetch

import fetch from "node-fetch";
import { HttpsProxyAgent } from "https-proxy-agent";

const agent = new HttpsProxyAgent("http://USER:PASS@proxy.proxyitaly.com:10001");
const res = await fetch("https://api.ipify.org", { agent });
console.log(await res.text());

Playwright (JavaScript)

import { chromium } from "playwright";

const browser = await chromium.launch({
  proxy: {
    server: "http://proxy.proxyitaly.com:10001",
    username: "USER",
    password: "PASS",
  },
});
const page = await browser.newPage();
await page.goto("https://api.ipify.org");
console.log(await page.textContent("body"));
await browser.close();

Playwright (Python)

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://proxy.proxyitaly.com:10001",
        "username": "USER",
        "password": "PASS",
    })
    page = browser.new_page()
    page.goto("https://api.ipify.org")
    print(page.text_content("body"))
    browser.close()

Puppeteer

import puppeteer from "puppeteer";

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://proxy.proxyitaly.com:10001"],
});
const page = await browser.newPage();
await page.authenticate({ username: "USER", password: "PASS" });
await page.goto("https://api.ipify.org");
console.log(await page.evaluate(() => document.body.textContent));
await browser.close();

Selenium (Python)

from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy, ProxyType

proxy = Proxy()
proxy.proxy_type = ProxyType.MANUAL
proxy.http_proxy = "USER:PASS@proxy.proxyitaly.com:10001"
proxy.ssl_proxy = "USER:PASS@proxy.proxyitaly.com:10001"

options = webdriver.ChromeOptions()
options.proxy = proxy
driver = webdriver.Chrome(options=options)
driver.get("https://api.ipify.org")
print(driver.page_source)
driver.quit()

Firecrawl

from firecrawl import FirecrawlApp
import os

os.environ["HTTP_PROXY"] = "http://USER:PASS@proxy.proxyitaly.com:10001"
os.environ["HTTPS_PROXY"] = "http://USER:PASS@proxy.proxyitaly.com:10001"

app = FirecrawlApp(api_key="your-api-key")
result = app.scrape_url("https://example.com")
print(result)

Crawl4AI

from crawl4ai import AsyncWebCrawler

crawler = AsyncWebCrawler(
    proxy="http://USER:PASS@proxy.proxyitaly.com:10001"
)
result = await crawler.arun(url="https://example.com")
print(result.markdown)

LangChain

from langchain_community.document_loaders import AsyncHtmlLoader
import os

os.environ["HTTP_PROXY"] = "http://USER:PASS@proxy.proxyitaly.com:10001"
os.environ["HTTPS_PROXY"] = "http://USER:PASS@proxy.proxyitaly.com:10001"

loader = AsyncHtmlLoader(["https://example.com"])
docs = loader.load()
print(docs[0].page_content[:200])

n8n

// n8n HTTP Request Node — proxy configuration
{
  "url": "https://api.ipify.org",
  "options": {
    "proxy": {
      "host": "proxy.proxyitaly.com",
      "port": 10001,
      "auth": {
        "username": "USER",
        "password": "PASS"
      }
    }
  }
}

5. API Reference

POST /api/rotate

Ruota IP di una porta. Richiede autenticazione via sessione dashboard.

Body: { "portNumber": 10001 }
GET /api/rotate/[token]

Magic link per rotazione pubblica. Rate limit: 1 richiesta ogni 10 secondi.

Response: { "ip": "...", "carrier": "...", "rotated_at": "..." }
GET /api/proxy-status

Stato di tutte le porte dell'utente. Richiede autenticazione.

6. Rotazione IP

Quattro modalità disponibili:

Manual
Trigger dalla dashboard con un click
Interval
Rotazione automatica ogni N minuti (15/30/45/60/90/120)
Scheduled
Rotazione a orari specifici UTC (es. 08:00, 14:30)
API Link
GET pubblica con token per porta, rate limit 10s

7. Tool supportati

curl
Python requests
httpx
Scrapy
Node axios
Node fetch
Playwright (JS)
Playwright (Python)
Puppeteer
Selenium
Firecrawl
Crawl4AI
LangChain
n8n

8. FAQ tecnica

Ogni porta è dedicata?
Sì. Una porta corrisponde a una SIM fisica dedicata 1:1.
Supportate SOCKS5?
Sì, ogni porta supporta HTTP e SOCKS5.
Ci sono limiti traffico?
No, il traffico è illimitato su ogni porta attiva.
Posso ruotare da API?
Sì, con endpoint autenticato o link token pubblico per porta.
Posso schedulare la rotazione?
Sì, modalità interval e scheduled (orari UTC).
Quanto dura il Trial?
72 ore dalla provisioning della porta.
Create nuove porte sui rinnovi?
No. Il rinnovo estende la scadenza della stessa porta.
Conservate il traffico utente?
No. Non registriamo contenuti o URL di destinazione.

9. Inizia ora

Attiva un Trial in pochi minuti o contattaci per setup custom.

Hai domande? Scrivici su Telegram