{"id":"proxies","name":"proxies","summary":"Oxylabsプロキシネットワーク:住宅用、モバイル用、共有データセンター/ISP、専用データセンター/ISPプロキシで、ジオターゲティング、IPローテーション、セッション永続性、ポートベースのスティッキーIPを備えています。","body":"# Oxylabs Proxies\n\n## Proxy Types Overview\n\n| Type | Host | Port | Best For |\n|------|------|------|----------|\n| Residential | `pr.oxylabs.io` | `7777` | High anonymity, geo-targeting |\n| Mobile | `pr.oxylabs.io` | `7777` | Mobile-specific content, highest trust |\n| Datacenter (shared) | `dc.oxylabs.io` | `8000` rotation / `8001+` assigned/static | Speed, high volume |\n| ISP (shared) | `isp.oxylabs.io` | `8000` rotation / `8001+` assigned/static | Speed + anonymity balance |\n| Dedicated Datacenter | `ddc.oxylabs.io` | `8000` rotation / `8001+` assigned/static | Owned IPs, port-based access |\n| Dedicated ISP | `disp.oxylabs.io` | `8000` rotation / `8001+` assigned/static | Owned ISP IPs, ASN locked |\n\nResidential/Mobile use `pr.oxylabs.io:7777` with username session parameters. Datacenter/ISP and Dedicated self-service products use proxy-list ports starting at `8001` for assigned/static IPs and `8000` for automatic rotation.\n\n## Environment Variables\n\nUse credentials for the specific proxy product family:\n\n| Product family | Variables | Username prefix |\n|----------------|-----------|-----------------|\n| Residential, Mobile | `OXY_RES_USERNAME`, `OXY_RES_PASSWORD` | `customer-` |\n| Datacenter, ISP, Dedicated Datacenter, Dedicated ISP | `OXY_DC_USERNAME`, `OXY_DC_PASSWORD` | `user-` for self-service/shared |\n\n## Authentication Format\n\n```\ncustomer-USERNAME:PASSWORD    # Residential, Mobile\nuser-USERNAME:PASSWORD          # Shared Datacenter, Shared ISP\n```\n\nDedicated proxy auth (Self-Service vs Enterprise) is in [dedicated-datacenter.md](dedicated-datacenter.md) and [dedicated-isp.md](dedicated-isp.md).\n\nUse separate credentials for Residential/Mobile (`OXY_RES_USERNAME`, `OXY_RES_PASSWORD`) and Datacenter/ISP (`OXY_DC_USERNAME`, `OXY_DC_PASSWORD`).\n\nWith parameters:\n```\ncustomer-USERNAME-cc-US-city-new_york-sessid-abc123:PASSWORD\n```\n\n## Quick Start\n\n**Residential/Mobile proxy:**\n```bash\ncurl -x \"pr.oxylabs.io:7777\" \\\n  -U \"customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD\" \\\n  \"https://ip.oxylabs.io/location\"\n```\n\n**Datacenter proxy:**\n```bash\ncurl -x \"dc.oxylabs.io:8000\" \\\n  -U \"user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD\" \\\n  \"https://ip.oxylabs.io/location\"\n```\n\n**ISP proxy:**\n```bash\ncurl -x \"isp.oxylabs.io:8001\" \\\n  -U \"user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD\" \\\n  \"https://ip.oxylabs.io/location\"\n```\n\nFor Datacenter, ISP, Dedicated Datacenter, and Dedicated ISP proxies, use dashboard proxy-list ports starting at `8001` for assigned/static IPs; the first listed IP uses `8001`. Switch to port `8000` only when the task calls for automatic rotation.\n\n## Geo-Targeting Parameters\n\nFor Residential/Mobile, append username parameters with hyphens unless noted:\n\n| Parameter | Format | Example |\n|-----------|--------|---------|\n| `cc` | ISO 3166-1 alpha-2 | `-cc-US`, `-cc-DE`, `-cc-GB` |\n| `city` | English, underscores for spaces | `-city-new_york`, `-city-los_angeles` |\n| `st` | US states with `us_` prefix | `-st-us_california`, `-st-us_texas` |\n| `postalcode` | 5-digit US ZIP, pair with `cc-US` | `-cc-US-postalcode-90210` |\n| `ASN` | Residential/Mobile carrier ASN | `-ASN-21928` |\n| `X-Oxylabs-Geolocation` | Proxy header `lat:lon;radius_miles` | `49.9235:-97.0811;10` |\n\nZIP targeting is US-only. Coordinate radius cannot be lower than 10 miles. If both country and ASN are used, country applies.\n\n**Example with geo-targeting:**\n```bash\ncurl -x \"pr.oxylabs.io:7777\" \\\n  -U \"customer-$OXY_RES_USERNAME-cc-US-city-new_york:$OXY_RES_PASSWORD\" \\\n  \"https://ip.oxylabs.io/location\"\n```\n\nFor Shared Datacenter/ISP country rotation, use `-country-US` with `user-` credentials on the rotation port.\n\n## Session Control\n\n| Parameter | Description | Notes |\n|-----------|-------------|-------|\n| `sessid` | Keep the same IP across requests | Standard session is 10 minutes or up to 60s of inactivity |\n| `sessid_oneip` | Bind the session to one exact exit node | Returns `502` if that IP becomes unavailable |\n| `sesstime` | Set session duration in minutes with `sessid` or `sessid_oneip` | Residential backconnect supports up to 1440 minutes; some entry modes cap lower |\n\n**Sticky session example:**\n```bash\ncurl -x \"pr.oxylabs.io:7777\" \\\n  -U \"customer-$OXY_RES_USERNAME-cc-US-sessid-mysession123:$OXY_RES_PASSWORD\" \\\n  \"https://example.com\"\n```\n\n**Timed session (5 minutes):**\n```bash\ncurl -x \"pr.oxylabs.io:7777\" \\\n  -U \"customer-$OXY_RES_USERNAME-sessid-abc123-sesstime-5:$OXY_RES_PASSWORD\" \\\n  \"https://example.com\"\n```\n\n## Choosing the Right Proxy Type\n\n| Need | Recommended |\n|------|-------------|\n| Highest anonymity | Residential |\n| Mobile app content | Mobile |\n| Speed & volume | Datacenter |\n| Speed + anonymity | ISP |\n| Owned dedicated IPs | Dedicated Datacenter or Dedicated ISP |\n| Geo-restricted content | Residential/Mobile with `cc`/`city`/`postalcode`, or DC/ISP by country/assigned port where suitable |\n\n## Default Behavior\n\n- Without parameters: random IP for each request\n- Residential/Mobile share the same endpoint but different IP pools\n- Sessions auto-expire and get new IPs\n\n## Additional Resources\n\n- Shared proxy details (Residential, Mobile, Datacenter, ISP): [proxy-types.md](proxy-types.md)\n- Dedicated Datacenter (Self-Service + Enterprise): [dedicated-datacenter.md](dedicated-datacenter.md)\n- Dedicated ISP (Self-Service + Enterprise): [dedicated-isp.md](dedicated-isp.md)\n- Code examples (all languages): [examples.md](examples.md)","author":"@oxylabs","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/oxylabs/agent-skills/tree/main/skills/proxies","license":"MIT","category":null,"lang":"en","tokens":1505,"stars":0,"calls30d":2,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[{"path":"dedicated-datacenter.md","size":5960,"sha256":"2e5ed7d10ffc788c4e14280c3dc3b26f8be5826dd412fdef95db1f59d5a974c5"},{"path":"dedicated-isp.md","size":5823,"sha256":"8d13f37e86a863aa8dfac774a5a9d291f01964dcace60791b6dfc37d4f17ed70"},{"path":"examples.md","size":8550,"sha256":"d9a06822fb45cc657455b7092fcf3f47b765cc02052b53992aeb0a3bb8ebb311"},{"path":"proxy-types.md","size":5573,"sha256":"10f9a29889c82e34da4d64ec5be36167986e88cadf5939a2f420f4f1c7943b6f"}],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":["api.oxylabs.io","dashboard.oxylabs.io","dc-api-spec.oxylabs.io","ddc.oxylabs.io","disp.oxylabs.io","ip.oxylabs.io","pr.oxylabs.io","proxy.oxylabs.io","stat.ripe.net"]}}