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.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 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.

Hai domande? Scrivici su Telegram