[{"data":1,"prerenderedAt":557},["ShallowReactive",2],{"doc-en-usage\u002Fusername-syntax":3},{"id":4,"title":5,"body":6,"description":549,"extension":550,"faq":551,"meta":552,"navigation":287,"path":553,"seo":554,"stem":555,"__hash__":556},"docs\u002Fdocs\u002Fen\u002Fusage\u002Fusername-syntax.md","Username Parameter Syntax",{"type":7,"value":8,"toc":542},"minimark",[9,13,18,29,40,44,202,206,238,242,446,453,457,538],[10,11,12],"p",{},"In credential mode, all geo-targeting and session control is done by appending parameters to the username — the password never changes. This page is the complete syntax reference.",[14,15,17],"h2",{"id":16},"structure","Structure",[19,20,25],"pre",{"className":21,"code":23,"language":24},[22],"language-text","{account}-pool-flow[-region-{country code}][-state-{state}][-city-{city}][-asn-{ASN}][-sid-{8-char random}-ttl-{minutes}]\n","text",[26,27,23],"code",{"__ignoreMap":28},"",[10,30,31,32,35,36],{},"Left to right: account body → pool identifier (always ",[26,33,34],{},"-pool-flow",") → geo-targeting parameters → session parameters. ",[37,38,39],"strong",{},"The order is fixed and cannot be rearranged.",[14,41,43],{"id":42},"parameters","Parameters",[45,46,47,63],"table",{},[48,49,50],"thead",{},[51,52,53,57,60],"tr",{},[54,55,56],"th",{},"Parameter",[54,58,59],{},"Format",[54,61,62],{},"Description",[64,65,66,79,106,126,149,173,186],"tbody",{},[51,67,68,73,76],{},[69,70,71],"td",{},[26,72,34],{},[69,74,75],{},"Fixed value",[69,77,78],{},"Residential pool identifier, required in credential mode",[51,80,81,86,89],{},[69,82,83],{},[26,84,85],{},"-region-{CC}",[69,87,88],{},"ISO two-letter country code",[69,90,91,92,95,96,95,99,95,102,105],{},"Country targeting, e.g. ",[26,93,94],{},"US",", ",[26,97,98],{},"GB",[26,100,101],{},"JP",[26,103,104],{},"AE","; free in all cases",[51,107,108,113,116],{},[69,109,110],{},[26,111,112],{},"-state-{State}",[69,114,115],{},"State\u002Fprovince name",[69,117,118,119,122,123],{},"Must be used together with ",[26,120,121],{},"region",", e.g. ",[26,124,125],{},"California",[51,127,128,133,136],{},[69,129,130],{},[26,131,132],{},"-city-{city}",[69,134,135],{},"City name, lowercase, no spaces",[69,137,138,122,143,95,146],{},[37,139,118,140],{},[26,141,142],{},"state",[26,144,145],{},"losangeles",[26,147,148],{},"newyork",[51,150,151,156,162],{},[69,152,153],{},[26,154,155],{},"-asn-{ASN}",[69,157,158,161],{},[26,159,160],{},"AS"," + digits",[69,163,164,165,168,169,172],{},"ASN (carrier network) targeting, e.g. ",[26,166,167],{},"AS15802","; ",[37,170,171],{},"mutually exclusive with state\u002Fcity",", combine with region only",[51,174,175,180,183],{},[69,176,177],{},[26,178,179],{},"-sid-{seed}",[69,181,182],{},"8 random alphanumeric characters",[69,184,185],{},"Sticky session ID; the same sid reuses the same IP, a new sid gets a new IP",[51,187,188,193,196],{},[69,189,190],{},[26,191,192],{},"-ttl-{n}",[69,194,195],{},"Integer, 1–120",[69,197,198,199],{},"Sticky session hold time in minutes; always paired with ",[26,200,201],{},"sid",[14,203,205],{"id":204},"combination-rules","Combination rules",[207,208,209,216,219,222,225],"ul",{},[210,211,212,213],"li",{},"Rotation only, no targeting: ",[26,214,215],{},"USERNAME-pool-flow",[210,217,218],{},"Targeting refines step by step: region → region+state → region+state+city",[210,220,221],{},"ASN targeting cannot be combined with state\u002Fcity",[210,223,224],{},"Sticky session parameters always come last",[210,226,227,228,230,231,234,235],{},"Without ",[26,229,201],{},"\u002F",[26,232,233],{},"ttl",", the default applies: ",[37,236,237],{},"a new IP on every request",[14,239,241],{"id":240},"full-examples","Full examples",[19,243,247],{"className":244,"code":245,"language":246,"meta":28,"style":28},"language-bash shiki shiki-themes github-light","# 1. Global random IP, rotating per request\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow:PASSWORD\" https:\u002F\u002Fipinfo.io\n\n# 2. Specific country (US)\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow-region-US:PASSWORD\" https:\u002F\u002Fipinfo.io\n\n# 3. Down to state level (California, US)\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow-region-US-state-California:PASSWORD\" https:\u002F\u002Fipinfo.io\n\n# 4. Down to city level (Los Angeles, California, US)\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow-region-US-state-California-city-losangeles:PASSWORD\" https:\u002F\u002Fipinfo.io\n\n# 5. ASN targeting (UAE, AS15802)\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow-region-AE-asn-AS15802:PASSWORD\" https:\u002F\u002Fipinfo.io\n\n# 6. Country + sticky session (same US IP held for 30 minutes)\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30:PASSWORD\" https:\u002F\u002Fipinfo.io\n\n# 7. City-level targeting + sticky session\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow-region-US-state-California-city-losangeles-sid-a1b2c3d4-ttl-30:PASSWORD\" https:\u002F\u002Fipinfo.io\n","bash",[26,248,249,258,282,289,295,311,316,322,338,343,349,365,370,376,392,397,403,419,424,430],{"__ignoreMap":28},[250,251,254],"span",{"class":252,"line":253},"line",1,[250,255,257],{"class":256},"sAwPA","# 1. Global random IP, rotating per request\n",[250,259,261,265,269,273,276,279],{"class":252,"line":260},2,[250,262,264],{"class":263},"s7eDp","curl",[250,266,268],{"class":267},"sYu0t"," -x",[250,270,272],{"class":271},"sYBdl"," proxy.eproxies.net:23333",[250,274,275],{"class":267}," -U",[250,277,278],{"class":271}," \"USERNAME-pool-flow:PASSWORD\"",[250,280,281],{"class":271}," https:\u002F\u002Fipinfo.io\n",[250,283,285],{"class":252,"line":284},3,[250,286,288],{"emptyLinePlaceholder":287},true,"\n",[250,290,292],{"class":252,"line":291},4,[250,293,294],{"class":256},"# 2. Specific country (US)\n",[250,296,298,300,302,304,306,309],{"class":252,"line":297},5,[250,299,264],{"class":263},[250,301,268],{"class":267},[250,303,272],{"class":271},[250,305,275],{"class":267},[250,307,308],{"class":271}," \"USERNAME-pool-flow-region-US:PASSWORD\"",[250,310,281],{"class":271},[250,312,314],{"class":252,"line":313},6,[250,315,288],{"emptyLinePlaceholder":287},[250,317,319],{"class":252,"line":318},7,[250,320,321],{"class":256},"# 3. Down to state level (California, US)\n",[250,323,325,327,329,331,333,336],{"class":252,"line":324},8,[250,326,264],{"class":263},[250,328,268],{"class":267},[250,330,272],{"class":271},[250,332,275],{"class":267},[250,334,335],{"class":271}," \"USERNAME-pool-flow-region-US-state-California:PASSWORD\"",[250,337,281],{"class":271},[250,339,341],{"class":252,"line":340},9,[250,342,288],{"emptyLinePlaceholder":287},[250,344,346],{"class":252,"line":345},10,[250,347,348],{"class":256},"# 4. Down to city level (Los Angeles, California, US)\n",[250,350,352,354,356,358,360,363],{"class":252,"line":351},11,[250,353,264],{"class":263},[250,355,268],{"class":267},[250,357,272],{"class":271},[250,359,275],{"class":267},[250,361,362],{"class":271}," \"USERNAME-pool-flow-region-US-state-California-city-losangeles:PASSWORD\"",[250,364,281],{"class":271},[250,366,368],{"class":252,"line":367},12,[250,369,288],{"emptyLinePlaceholder":287},[250,371,373],{"class":252,"line":372},13,[250,374,375],{"class":256},"# 5. ASN targeting (UAE, AS15802)\n",[250,377,379,381,383,385,387,390],{"class":252,"line":378},14,[250,380,264],{"class":263},[250,382,268],{"class":267},[250,384,272],{"class":271},[250,386,275],{"class":267},[250,388,389],{"class":271}," \"USERNAME-pool-flow-region-AE-asn-AS15802:PASSWORD\"",[250,391,281],{"class":271},[250,393,395],{"class":252,"line":394},15,[250,396,288],{"emptyLinePlaceholder":287},[250,398,400],{"class":252,"line":399},16,[250,401,402],{"class":256},"# 6. Country + sticky session (same US IP held for 30 minutes)\n",[250,404,406,408,410,412,414,417],{"class":252,"line":405},17,[250,407,264],{"class":263},[250,409,268],{"class":267},[250,411,272],{"class":271},[250,413,275],{"class":267},[250,415,416],{"class":271}," \"USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30:PASSWORD\"",[250,418,281],{"class":271},[250,420,422],{"class":252,"line":421},18,[250,423,288],{"emptyLinePlaceholder":287},[250,425,427],{"class":252,"line":426},19,[250,428,429],{"class":256},"# 7. City-level targeting + sticky session\n",[250,431,433,435,437,439,441,444],{"class":252,"line":432},20,[250,434,264],{"class":263},[250,436,268],{"class":267},[250,438,272],{"class":271},[250,440,275],{"class":267},[250,442,443],{"class":271}," \"USERNAME-pool-flow-region-US-state-California-city-losangeles-sid-a1b2c3d4-ttl-30:PASSWORD\"",[250,445,281],{"class":271},[447,448,450],"hint",{"type":449},"info",[10,451,452],{},"Not sure how to compose the parameters? The dashboard's Proxy Settings page has a visual builder: pick a country\u002Fstate\u002Fcity\u002Fsession type and it generates the complete username in real time — just copy it. The supported country and city lists are also searchable there.",[14,454,456],{"id":455},"common-errors","Common errors",[45,458,459,472],{},[48,460,461],{},[51,462,463,466,469],{},[54,464,465],{},"Symptom",[54,467,468],{},"Cause",[54,470,471],{},"Fix",[64,473,474,487,506,524],{},[51,475,476,479,484],{},[69,477,478],{},"Authentication failed (407)",[69,480,481,482],{},"Username typo or missing ",[26,483,34],{},[69,485,486],{},"Verify with the dashboard builder",[51,488,489,492,500],{},[69,490,491],{},"City targeting not applied",[69,493,494,497,498],{},[26,495,496],{},"city"," used without ",[26,499,142],{},[69,501,502,503],{},"Add ",[26,504,505],{},"-state-{state}",[51,507,508,511,518],{},[69,509,510],{},"ASN targeting not applied",[69,512,513,514,230,516],{},"Mixed with ",[26,515,142],{},[26,517,496],{},[69,519,520,521,523],{},"ASN combines with ",[26,522,121],{}," only",[51,525,526,529,532],{},[69,527,528],{},"IP keeps changing",[69,530,531],{},"No sticky session in use",[69,533,534,535],{},"Append ",[26,536,537],{},"-sid-{8 chars}-ttl-{minutes}",[539,540,541],"style",{},"html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":28,"searchDepth":260,"depth":260,"links":543},[544,545,546,547,548],{"id":16,"depth":260,"text":17},{"id":42,"depth":260,"text":43},{"id":204,"depth":260,"text":205},{"id":240,"depth":260,"text":241},{"id":455,"depth":260,"text":456},"In credential mode, all geo-targeting and session control is done by appending parameters to the username — the password never changes. This page is the…","md",null,{},"\u002Fdocs\u002Fen\u002Fusage\u002Fusername-syntax",{"title":5,"description":549},"docs\u002Fen\u002Fusage\u002Fusername-syntax","v5JU4bvHBfY7EK1fe8V4XCnO7X9feFq3FE5Eovks6g8",1785671055506]