Actor picture

Residential Proxy Probe

jancurn/residential-proxy-probe

Find residential proxy sessions on Apify Proxy with target IP addresses geo-located in specific postal codes or DMAs.

No credit card required

Author's avatarJan Čurn
  • Modified
  • Users124
  • Runs1,479
Actor picture
Residential Proxy Probe

Country

countryCode

Required

string

Country for the residential proxies. The values must be lower-cased ISO 3166 country codes supported by Apify Proxy.

Options:

"af", "al", "dz", "as", "ad", "ao", "ai", "aq", "ag", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "by", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "bv", "br", "io", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "ky", "cf", "td", "cl", "cn", "cx", "cc", "co", "km", "cg", "cd", "ck", "cr", "ci", "hr", "cu", "cy", "cz", "dk", "dj", "dm", "do", "ec", "eg", "sv", "gq", "er", "ee", "et", "fk", "fo", "fj", "fi", "fr", "gf", "pf", "tf", "ga", "gm", "ge", "de", "gh", "gi", "gr", "gl", "gd", "gp", "gu", "gt", "gn", "gw", "gy", "ht", "hm", "va", "hn", "hk", "hu", "is", "in", "id", "ir", "iq", "ie", "il", "it", "jm", "jp", "jo", "kz", "ke", "ki", "kp", "kr", "kw", "kg", "la", "lv", "lb", "ls", "lr", "ly", "li", "lt", "lu", "mo", "mk", "mg", "mw", "my", "mv", "ml", "mt", "mh", "mq", "mr", "mu", "yt", "mx", "fm", "md", "mc", "mn", "ms", "ma", "mz", "mm", "na", "nr", "np", "nl", "an", "nc", "nz", "ni", "ne", "ng", "nu", "nf", "mp", "no", "om", "pk", "pw", "ps", "pa", "pg", "py", "pe", "ph", "pn", "pl", "pt", "pr", "qa", "re", "ro", "ru", "rw", "sh", "kn", "lc", "pm", "vc", "ws", "sm", "st", "sa", "sn", "cs", "sc", "sl", "sg", "sk", "si", "sb", "so", "za", "gs", "es", "lk", "sd", "sr", "sj", "sz", "se", "ch", "sy", "tw", "tj", "tz", "th", "tl", "tg", "tk", "to", "tt", "tn", "tr", "tm", "tc", "tv", "ug", "ua", "ae", "uk", "us", "um", "uy", "uz", "vu", "ve", "vn", "vg", "vi", "wf", "eh", "ye", "zm", "zw"

Postal codes

postalCodes

Optional

string

A whitespace-separated list of postal codes from which you need residential proxies. It cannot be used together with DMA codes.

DMA codes

dmaCodes

Optional

string

A whitespace-separated list of Designated Market Area (DMA) codes as defined by Nielsen from which you need residential proxies. It cannot be used together with Postal codes.

Min sessions per region

minSessionsPerRegion

Optional

integer

Minimum number of residential proxy sessions to maintain and keep alive for a single postal code or DMA (whichever is specified). The higher the value, the more residential proxy traffic the actor will consume!

Max sessions per region

maxSessionsPerRegion

Optional

integer

Maximum number of residential proxy sessions to maintain and keep alive for a single postal code or DMA (whichever is specified). The higher the value, the more residential proxy traffic the actor will consume!

New sessions per heartbeat

newSessionsPerHeartbeat

Optional

integer

If there are not enough session per region to meet the minSessionsPerRegion criteria, we're adding new session in every heartbeat (i.e. every 20 seconds). The higher the value, the more residential proxy traffic the actor will consume, but the faster it will find enough matching sessions.

Key-value store name

keyValueStoreName

Optional

string

Name of the Key-value store where to store the JSON file with the state. If empty, the actor stores data to the default key-value store associated with the actor run.

Key-value record name

recordKey

Required

string

The name of the record in the key-value store where the JSON file with the state is stored.