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 riavvio connessione. 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.
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?
SOCKS5 è supportato dal server proxy ed è disponibile su richiesta: scrivici a support@proxyitaly.com e lo abilitiamo per la tua porta. Di default le credenziali che ricevi sono per HTTP/HTTPS.
Ci sono limiti traffico?
No, il traffico è illimitato su ogni porta attiva.
Quanto dura la prova?
48 ore dall'attivazione. La prova usa uno slot condiviso a coda: paghi €9,90 subito per prenotare il posto e vieni attivato con credenziali dedicate quando è il tuo turno.
Create nuove porte sui rinnovi?
No. Il rinnovo estende la scadenza della stessa porta.
Conservate il traffico utente?
Non registriamo il CONTENUTO del traffico né gli URL completi. Registriamo però, per 180 giorni, i metadati di connessione necessari a gestire abusi e rispondere alle autorità: data e ora, account usato, indirizzo IP da cui ti colleghi, host e porta di destinazione e volume di dati. Dettagli nell'Informativa privacy.
9. Inizia ora
Attiva un Trial in pochi minuti o contattaci per setup custom.