Developers

Integrations

Connection guide

AdsPower

Assign a custom connection to a browser profile and test it before starting work.

AdsPower supplied opening artwork
Supplied integration artwork. View full size

Before you start

An active proxy connection with its assigned protocol, hostname, port, full username and password. Copy those fields from your account or activation details. A browser profile does not create proxy credentials.

An AdsPower account and installed browser application. This guide covers a single profile with a custom proxy. It does not assume that every Crawlhub product offers every protocol or a fixed IP.

A custom proxy for the profile

AdsPower manages browser-profile settings and supports custom HTTP, HTTPS and SOCKS5 proxies. The protocol and account details must match the endpoint assigned by your proxy service.

Profile-level configuration
Keep the intended connection in the profile’s Proxy settings.
Separate authentication
Proxy username and password are separate from the account used to sign in to AdsPower.
A connection test
Use Check Proxy before saving or opening the profile.
Session continuity
Use a fixed assignment or the intended sticky-session configuration when the profile needs a stable exit IP.

1. Create or edit a profile

Open AdsPower and select New Profile, or edit the profile you want to configure. Give the profile a name that identifies its purpose.

Open its Proxy section and choose Custom. Leave unrelated browser fingerprint settings at the values required by your workflow.

AdsPower: create a browser profile
Document interface reference: create a browser profile. View full size

2. Add the connection

Choose the proxy protocol assigned to your endpoint. Enter the Host:Port, Proxy username and Proxy Password fields. AdsPower can also parse a provider-supplied IP:port:username:password string into the fields.

Copy the complete assigned username. Do not add country, city or session suffixes unless those values are part of your service’s documented configuration. Leave Change IP URL empty unless your service explicitly supplies one.

Enter raw credentials in separate username and password fields. URL-encode them only when a client requires a proxy URL; do not paste an encoded password into a normal password field.

The new Crawlhub v1 username specification is documented in the proxy parameter reference. Its planned gateway naming is separate from the live connection details assigned to an activated account.

Crawlhub v1 proxy parameters

Connection fieldWhat to enter
ProtocolProtocol assigned to this proxy endpoint
HostnameAssigned proxy hostname, without a URL path
PortAssigned port for the selected protocol
UsernameFull assigned username, including configured session or location values
PasswordProxy password, not the browser-tool account password
AdsPower: residential proxy fields
Document interface reference: residential proxy fields. View full size
AdsPower: ISP proxy fields
Document interface reference: ISP proxy fields. View full size
AdsPower: datacenter proxy fields
Document interface reference: datacenter proxy fields. View full size

3. Check the proxy

Click Check Proxy. A passed test means AdsPower connected successfully; inspect its reported IP and location as well.

If the test fails, correct the protocol, host, port or login before launching the profile. A saved profile by itself is not proof of a working proxy connection.

AdsPower: connection-check example
Document interface reference: connection-check example. View full size

4. Save and open the browser

Click OK to save the profile, find it in Profiles and click Open. Check the exit IP from a page inside that browser.

Keep a fixed assigned IP or sticky session when you need continuity. Rotating residential connections do not automatically give each profile a permanent unique IP, and a proxy alone does not guarantee that accounts cannot be associated.

AdsPower: launch the saved profile
Document interface reference: launch the saved profile. View full size

Troubleshooting

Connection test failed

Check the endpoint’s assigned protocol and port, then confirm the complete username and proxy password.

Exit location differs

Inspect the configured location and session values in your proxy account instead of adding guessed username suffixes.

IP changes after a restart

Confirm the assignment type and session lifetime. A browser profile does not pin an otherwise rotating connection.

Next steps

Browse integration guides or review the connection fields.

Open the tool documentation

Connect AdsPower to Crawlhub

Original closing illustration. Its copy is illustrative; proxy use does not guarantee account unlinkability, a unique IP for every profile or successful access. View full size

Start freeTalk to expert

Search documentation

Search guides, products and reference pages.