Documentazione Proxy Italy
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.org2. Credenziali
- Host: proxy.proxyitaly.com
- Porta: 10001 (o porta assegnata)
- User: formato user_{userId8}_{port}
- Password: generata automaticamente alla provisioning
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.orgPython 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 = TrueNode.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.