> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/es/proxies/residential-proxies.md). # Residential Proxies Descubre todo sobre los Residential Proxies de Oxylabs, ejemplos de código, parámetros de segmentación por ubicación y recursos de resolución de problemas. Oxylabs [**Residential Proxies**](https://oxylabs.io/products/residential-proxy-pool) usan direcciones IP reales proporcionadas por proveedores de servicios de Internet (ISP) conectadas a dispositivos físicos en todo el mundo. Estos proxies rotan automáticamente con cada solicitud y admiten segmentación detallada por país, ciudad, estado, código postal, ASN y sesión. {% hint style="info" %} **¿Conectándote mediante IPs en lista blanca?** Si prefieres autenticarte mediante lista blanca de IP en lugar de `nombre de usuario`/`contraseña` credenciales, sigue nuestra [guía de autenticación por lista blanca de IP y subdominios](/products/es/proxies/residential-proxies/whitelisting-ips.md). {% endhint %} ## Consulta básica {% hint style="info" %} Nuestros Residential Proxies admiten `HTTP`, `HTTPS`, `HTTP/3 (MASQUE)`, y `SOCKS5` protocolos. Puede obtener más información sobre cómo usarlos [**aquí**](/products/es/proxies/residential-proxies/protocols.md). {% endhint %} Hacer una solicitud básica solo requiere proporcionar tus credenciales de usuario del proxy (`nombre de usuario` y `contraseña`) al nodo de entrada backconnect (`pr.oxylabs.io:7777`). Cada solicitud se enruta automáticamente a través de una dirección IP aleatoria. {% tabs %} {% tab title="cURL" %} ```shell curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location ``` {% endtab %} {% tab title="PHP" %} ```php ``` {% endtab %} {% tab title="Python" %} ```python import urllib.request username = 'USERNAME' password = 'PASSWORD' entry = f'http://customer-{username}:{password}@pr.oxylabs.io:7777' query = urllib.request.ProxyHandler({ 'http': entry, 'https': entry, }) execute = urllib.request.build_opener(query) print(execute.open('https://ip.oxylabs.io/location').read()) ``` {% endtab %} {% tab title="Java" %} ```java package example; import org.apache.http.HttpHost; import org.apache.http.client.fluent.*; public class Example { public static void main(String[] args) throws Exception { HttpHost entry = new HttpHost("pr.oxylabs.io", 7777); String query = Executor.newInstance() .auth(entry, "customer-USERNAME", "PASS") .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry)) .returnContent().asString(); System.out.println(query); } } ``` {% endtab %} {% tab title="C#" %} ```csharp using System; using System.Net; class Example { static void Main() { var client = new WebClient(); client.Proxy = new WebProxy("pr.oxylabs.io:7777"); client.Proxy.Credentials = new NetworkCredential("customer-USERNAME", "PASSWORD"); Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location")); } c ``` {% endtab %} {% tab title="Ruby" %} ```ruby require 'uri' require 'net/http' uri = URI.parse('https://ip.oxylabs.io/location') proxy = Net::HTTP::Proxy('pr.oxylabs.io', 7777, 'customer-USERNAME', 'PASSWORD') req = Net::HTTP::Get.new(uri.path) result = proxy.start(uri.host,uri.port) do |http| http.request(req) end puts result.body ``` {% endtab %} {% endtabs %} ### Respuesta de ejemplo Probando tu conexión contra devuelve datos de MaxMind, IP2Location, DB-IP e IPinfo.io. Los parámetros incluyen dirección IP, proveedor, país, ciudad, código postal, ASN, nombre de la organización y zona horaria. ```json { "ip": "185.220.101.5", "provider": "Comcast Cable", "country": "United States", "country_code": "US", "city": "New York", "zip": "10001", "asn": 7018, "organization": "ATT-INTERNET4", "timezone": "America/New_York" } ``` ## Personalización de tus solicitudes Una vez verificada una conexión básica, personaliza tus solicitudes según tus necesidades específicas:
Ubicación y geolocalizaciónAplica parámetros de país, ciudad, estado, continente, código postal, ASN o coordenadas.
Control de sesiónSesiones persistentes (sessid), duración de sesión (sesstime), vinculación a una sola IP (sessid_oneip), y rangos de puertos persistentes.
Protocolos y puertosConfigura HTTP, HTTPS, HTTP/3, y SOCKS5 conexiones.
Filtros avanzadosDirige a sistemas operativos específicos (platform) o versiones del protocolo IP.
Lista blanca de IPConéctate sin contraseñas usando autenticación basada en IP.
### Parámetros de consulta Un único proxy backconnect (`pr.oxylabs.io:7777)` te permite personalizar tu proxy mediante parámetros adicionales en el nombre de usuario (geolocalización, sesiones persistentes, etc.). Aquí tienes una muestra de credenciales con un desglose:
ParámetroTipoDescripción
customerObligatorioPrefijo de cadena del nombre de usuario (p. ej., customer-USERNAME).
ccUbicaciónCódigo de país ISO 3166-1 de 2 letras, sin distinción entre mayúsculas y minúsculas (p. ej., cc-DE, cc-US).
ciudadUbicaciónNombre de ciudad en inglés; requiere cc (p. ej., cc-US-city-los_angeles).
stUbicaciónNombre del estado de EE. UU. con us_ prefijo (p. ej., st-us_california).
cnUbicaciónCódigo de continente de 2 letras (p. ej., cn-EU, cn-AS).
postalcodeUbicaciónCódigo postal de EE. UU. de 5 dígitos; requiere cc-US (p. ej., postalcode-90210).
ASNUbicaciónNúmero de Sistema Autónomo (p. ej., ASN-21928).
geohashUbicaciónObjetivo de celdas de la cuadrícula Geohash de nivel 1–4 (p. ej., geohash-u09 para París).
sessidSesiónCadena aleatoria para mantener la IP entre solicitudes (predeterminado: 10 min).
sesstimeSesiónAmplía la duración de la sesión en minutos hasta 1440 min (p. ej., sesstime-30).
sessid_oneipSesiónVincula la sesión estrictamente a un único nodo de salida; falla con 502 si se cae.
platformFiltrarHuella digital del SO objetivo (windows, macos, linux, android, ios).
ipversionFiltrarRestringe el pool de Proxies a ipversion-4 o ipversion-6.
### Formatos comunes de cadenas de proxy Según tu flujo de trabajo, software de terceros o scripts personalizados, las credenciales del proxy pueden formatearse de varias maneras:
FormatoCaso de uso
HOST:PORT:USER:PASS
(pr.oxylabs.io:7777:customer-john:pass123)		Formato de puerta de enlace de entrada backconnect usado en herramientas de automatización estándar.
USER:PASS@HOST:PORT
(customer-john:pass123@pr.oxylabs.io:7777)		Formato URI estándar usado por cURL, Python requests, Node.js axios, etc.
IP:PORT:USER:PASS
(185.220.101.5:8000:john:pass123)		Formato de IP directa usado comúnmente en herramientas de botting y scrapers de escritorio.
USER:PASS:IP:PORT
(john:pass123:185.220.101.5:8000)		Formato de cadena invertida usado por herramientas heredadas que requieren análisis personalizado.
IP:PORT
(185.220.101.5:8000)		Formato con IP en la lista blanca (no se requiere nombre de usuario ni contraseña).
## Panel y gestión de cuenta * Accede a tu [Panel de Oxylabs](https://dashboard.oxylabs.io/en) para ver el uso de tráfico en tiempo real, estadísticas de solicitudes y administrar subusuarios. * Usa el generador automatizado [Endpoint Generator](/products/es/proxies/residential-proxies/endpoint-generator.md) para generar y exportar listas personalizadas de proxies en cURL, Python, PHP, Node.js, GO, Java o detalles personalizados para integraciones. * Administra subusuarios y realiza seguimiento del uso programáticamente mediante [Public API](/products/es/proxies/residential-proxies/public-api.md). ## ¿Necesitas asistencia técnica? Contacta a tu gestor de cuenta o a nuestro equipo de soporte 24/7 usando una de las opciones siguientes: * **Chat en vivo.** Accede al chat en vivo a través de tu panel o en el [**sitio web de Oxylabs**](https://oxylabs.io/) para preguntas rápidas o informes de errores. * **Correo electrónico**. Puedes contactarnos a través de [**support@oxylabs.io**](mailto:support@oxylabs.io). Recomendamos este método para preguntas o sugerencias menos urgentes. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developers.oxylabs.io/products/es/proxies/residential-proxies.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.