Ctrlk
Access Oxylabs dashboardContact us
x-twitter
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Setting up your first product

This guide starts once you have an Oxylabs account.

Every product follows the same three-step pattern: get access, connect, and send your first request. Access differs slightly across products, and they're grouped below by pattern accordingly. For how the credit balance, welcome credit, and plan changes work, see How pricing and billing work.

Residential Proxies, Mobile Proxies, Web Unblocker, and Agent Browser

You'll get a username and password. No need to choose quantity or country when creating the instance.

  1. Get your access. Go to the dashboard, choose the product, and select Create instance. You're required to name the instance before you can confirm it. Your username and password are generated as soon as you do.

  2. Connect.

Residential Proxies – open the Endpoint Generator, choose a location, and set a sticky or rotating session.

Mobile Proxies – connect through a single endpoint. With proxies pre-checked automatically, there's no IP list to import.

Web Unblocker – add the single Web Unblocker endpoint to your code.

Agent Browser – connect your tool. Puppeteer, Playwright, CDP, and MCP clients such as Claude are all supported.

  1. Send your first request. Add the endpoint to your script and run it. For Agent Browser, this means launching your session and starting to collect data.

Optionally, set a spending limit for the instance during creation. This caps how much of your shared credit balance it can draw each billing cycle.

Residential Proxies and Mobile Proxies also support IP allowlisting. See How can I whitelist IPs? for details.

ISP Proxies, Dedicated ISP Proxies, Datacenter Proxies, and Dedicated Datacenter Proxies

You'll need to choose an IP type, quantity, and country before you can access it.

  1. Get your access. Go to the dashboard, choose the product, and select Create instance. You're required to set the IP type, name the instance, and enter the quantity before you can confirm it. Your username and password are generated as soon as you do. You can also set a country and, for Dedicated ISP Proxies, an ASN provider, if needed.

  2. Connect. Use the endpoint generated from your instance.

  3. Send your first request. Add the endpoint to your script and run it.

Optionally, set a spending limit for the instance at creation. This caps how much of your shared credit balance it can draw each billing cycle.

Datacenter Proxies and Dedicated Datacenter Proxies also support IP allowlisting. See How can I whitelist IPs? for how to manage this later.

Web API

You'll get an API key instead of a username and password.

  1. Get your access. Go to the dashboard, choose Web API, and select Create instance. You're required to name the instance before you can confirm it. Your API key is generated as soon as you confirm it.

  2. Connect. Build your request. Choose a target and location, then request raw HTML or structured JSON.

  3. Send your first request. Run the request and get your data back.

Prefer a guided walkthrough?

Want to watch instead? This video covers the whole dashboard, including logging in, creating an instance, and checking status.

Full dashboard overview

Do more with your credits

Your credit balance works across every product. Add another instance anytime to try something new.

Head back to the dashboard

PreviousHow do I choose the right product?
NextHow pricing and billing work

Last updated

Was this helpful?