Learn how to connect your application to Apify Proxy. See the required parameters such as the correct username and password.
Below are the HTTP proxy connection settings for Apify Proxy.
|Parameter||Value / explanation|
|Username||Specifies the proxy parameters such as groups, session and location.
See username parameters below for details.
Note: this is not your Apify username.
|Password||Proxy password. Your password is displayed on the Proxy page in the Apify app.
In Apify actors, it is passed as the
See the environment variables docs for more details.
WARNING: All usage of Apify Proxy with your password is charged towards your account. Do not share the password with untrusted parties or use it from insecure networks – the password is sent unencrypted due to the HTTP protocol's limitations.
For example, if you're using datacenter proxies and want to use the
new_job_123 session using the
SHADER group, the username will be:
The table below describes the available parameters.
Set proxied requests to use servers from the selected groups.
If specified, all proxied requests with the same session identifier are routed
through the same IP address. For example
This parameter is optional. By default, each proxied request is assigned a
randomly picked least used IP address.
The session string can only contain numbers (0-9), letters (a-z or A-Z), dot (.),
underscore (_), a tilde (~). The maximum length is 50 characters.
If specified, all proxied requests will use proxy servers from a selected country.
Note that if there are no proxy servers
from the specified country, the connection will fail.
This parameter is optional. By default, the proxy uses all available
proxy servers from all countries.
If you do not want to specify either
session parameters and therefore use default behavior for both, set the username to
You can see which proxy groups you have access to on the Proxy page in the Apify app.
To use a specific proxy group (or multiple groups), specify it in the