[{"data":1,"prerenderedAt":500},["ShallowReactive",2],{"doc-en-agent-reference":3},{"id":4,"title":5,"body":6,"description":492,"extension":493,"faq":494,"meta":495,"navigation":196,"path":496,"seo":497,"stem":498,"__hash__":499},"docs\u002Fdocs\u002Fen\u002Fagent-reference.md","🤖 Agent Cheat Sheet",{"type":7,"value":8,"toc":485},"minimark",[9,13,18,29,39,43,49,52,138,141,147,151,216,303,346,350,357,429,437,441,481],[10,11,12],"p",{},"This page compresses everything you need to connect to EProxies onto one screen, for AI agents and developers who want fast lookups. Every example runs as-is once you substitute your credentials.",[14,15,17],"h2",{"id":16},"endpoints","Endpoints",[19,20,25],"pre",{"className":21,"code":23,"language":24},[22],"language-text","Proxy gateway:   proxy.eproxies.net:23333   (one port for HTTP \u002F HTTPS \u002F SOCKS5)\nDashboard:       https:\u002F\u002Fdashboard.eproxies.io\nAPI extraction:  https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fextract_ip   (whitelist mode)\nCountry list:    https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fcountry-list\n","text",[26,27,23],"code",{"__ignoreMap":28},"",[10,30,31,32],{},"Machine-readable API definition: ",[33,34,38],"a",{"href":35,"rel":36},"https:\u002F\u002Fwww.eproxies.io\u002Fdocs\u002Fopenapi.json",[37],"nofollow","OpenAPI specification",[14,40,42],{"id":41},"username-syntax-credential-mode","Username syntax (credential mode)",[19,44,47],{"className":45,"code":46,"language":24},[22],"{account}-pool-flow[-region-{country code}][-state-{state}][-city-{city}][-asn-{ASN}][-sid-{8-char random}-ttl-{minutes}]\n",[26,48,46],{"__ignoreMap":28},[10,50,51],{},"Rules:",[53,54,55,59,76,102,115],"ul",{},[56,57,58],"li",{},"Segment order is fixed; concatenate left to right as shown. The password never changes.",[56,60,61,64,65,68,69,68,72,75],{},[26,62,63],{},"region",": ISO 3166-1 two-letter country code, e.g. ",[26,66,67],{},"US",", ",[26,70,71],{},"GB",[26,73,74],{},"JP",".",[56,77,78,81,82,85,86,89,90,93,94],{},[26,79,80],{},"state",": full state\u002Fprovince name, e.g. ",[26,83,84],{},"California","; ",[26,87,88],{},"city",": city name in lowercase with spaces removed, e.g. ",[26,91,92],{},"losangeles",". ",[95,96,97,99,100,75],"strong",{},[26,98,88],{}," requires ",[26,101,80],{},[56,103,104,107,108,85,111,114],{},[26,105,106],{},"asn",": format ",[26,109,110],{},"AS15802",[95,112,113],{},"mutually exclusive with state \u002F city"," (combine with region only).",[56,116,117,120,121,124,125,127,128,130,131,134,135,137],{},[26,118,119],{},"sid"," + ",[26,122,123],{},"ttl",": sticky session. ",[26,126,119],{}," is an 8-character random alphanumeric string (generate it yourself; a new sid means a new IP); ",[26,129,123],{}," is the hold time in minutes, range ",[95,132,133],{},"1–120",". Without ",[26,136,119],{},", the IP rotates on every request.",[10,139,140],{},"Examples (simple to complex):",[19,142,145],{"className":143,"code":144,"language":24},[22],"USERNAME-pool-flow                                                    # Global random, rotate per request\nUSERNAME-pool-flow-region-US                                          # US IP\nUSERNAME-pool-flow-region-US-state-California                         # California, US\nUSERNAME-pool-flow-region-US-state-California-city-losangeles         # Los Angeles, California, US\nUSERNAME-pool-flow-region-AE-asn-AS15802                              # UAE, specific ASN\nUSERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30                      # US IP, held for 30 minutes\n",[26,146,144],{"__ignoreMap":28},[14,148,150],{"id":149},"minimal-working-examples","Minimal working examples",[19,152,156],{"className":153,"code":154,"language":155,"meta":28,"style":28},"language-bash shiki shiki-themes github-light","# HTTP proxy\ncurl -x proxy.eproxies.net:23333 -U \"USERNAME-pool-flow-region-US:PASSWORD\" https:\u002F\u002Fipinfo.io\n\n# SOCKS5 proxy (same port)\ncurl -x socks5:\u002F\u002FUSERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333 https:\u002F\u002Fipinfo.io\n","bash",[26,157,158,167,191,198,204],{"__ignoreMap":28},[159,160,163],"span",{"class":161,"line":162},"line",1,[159,164,166],{"class":165},"sAwPA","# HTTP proxy\n",[159,168,170,174,178,182,185,188],{"class":161,"line":169},2,[159,171,173],{"class":172},"s7eDp","curl",[159,175,177],{"class":176},"sYu0t"," -x",[159,179,181],{"class":180},"sYBdl"," proxy.eproxies.net:23333",[159,183,184],{"class":176}," -U",[159,186,187],{"class":180}," \"USERNAME-pool-flow-region-US:PASSWORD\"",[159,189,190],{"class":180}," https:\u002F\u002Fipinfo.io\n",[159,192,194],{"class":161,"line":193},3,[159,195,197],{"emptyLinePlaceholder":196},true,"\n",[159,199,201],{"class":161,"line":200},4,[159,202,203],{"class":165},"# SOCKS5 proxy (same port)\n",[159,205,207,209,211,214],{"class":161,"line":206},5,[159,208,173],{"class":172},[159,210,177],{"class":176},[159,212,213],{"class":180}," socks5:\u002F\u002FUSERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333",[159,215,190],{"class":180},[19,217,221],{"className":218,"code":219,"language":220,"meta":28,"style":28},"language-python shiki shiki-themes github-light","import requests\n\nproxy_url = \"http:\u002F\u002FUSERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333\"\nproxies = {\"http\": proxy_url, \"https\": proxy_url}\nprint(requests.get(\"https:\u002F\u002Fipinfo.io\", proxies=proxies, timeout=30).json())\n","python",[26,222,223,233,237,248,270],{"__ignoreMap":28},[159,224,225,229],{"class":161,"line":162},[159,226,228],{"class":227},"sD7c4","import",[159,230,232],{"class":231},"sgsFI"," requests\n",[159,234,235],{"class":161,"line":169},[159,236,197],{"emptyLinePlaceholder":196},[159,238,239,242,245],{"class":161,"line":193},[159,240,241],{"class":231},"proxy_url ",[159,243,244],{"class":227},"=",[159,246,247],{"class":180}," \"http:\u002F\u002FUSERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333\"\n",[159,249,250,253,255,258,261,264,267],{"class":161,"line":200},[159,251,252],{"class":231},"proxies ",[159,254,244],{"class":227},[159,256,257],{"class":231}," {",[159,259,260],{"class":180},"\"http\"",[159,262,263],{"class":231},": proxy_url, ",[159,265,266],{"class":180},"\"https\"",[159,268,269],{"class":231},": proxy_url}\n",[159,271,272,275,278,281,283,287,289,292,295,297,300],{"class":161,"line":206},[159,273,274],{"class":176},"print",[159,276,277],{"class":231},"(requests.get(",[159,279,280],{"class":180},"\"https:\u002F\u002Fipinfo.io\"",[159,282,68],{"class":231},[159,284,286],{"class":285},"sqxcx","proxies",[159,288,244],{"class":227},[159,290,291],{"class":231},"proxies, ",[159,293,294],{"class":285},"timeout",[159,296,244],{"class":227},[159,298,299],{"class":176},"30",[159,301,302],{"class":231},").json())\n",[19,304,308],{"className":305,"code":306,"language":307,"meta":28,"style":28},"language-javascript shiki shiki-themes github-light","const { HttpsProxyAgent } = require(\"https-proxy-agent\");\nconst axios = require(\"axios\");\n\nconst agent = new HttpsProxyAgent(\n  \"http:\u002F\u002FUSERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333\"\n);\naxios.get(\"https:\u002F\u002Fipinfo.io\", { httpsAgent: agent }).then((r) => console.log(r.data));\n","javascript",[26,309,310,315,320,324,329,334,340],{"__ignoreMap":28},[159,311,312],{"class":161,"line":162},[159,313,314],{},"const { HttpsProxyAgent } = require(\"https-proxy-agent\");\n",[159,316,317],{"class":161,"line":169},[159,318,319],{},"const axios = require(\"axios\");\n",[159,321,322],{"class":161,"line":193},[159,323,197],{"emptyLinePlaceholder":196},[159,325,326],{"class":161,"line":200},[159,327,328],{},"const agent = new HttpsProxyAgent(\n",[159,330,331],{"class":161,"line":206},[159,332,333],{},"  \"http:\u002F\u002FUSERNAME-pool-flow-region-US:PASSWORD@proxy.eproxies.net:23333\"\n",[159,335,337],{"class":161,"line":336},6,[159,338,339],{},");\n",[159,341,343],{"class":161,"line":342},7,[159,344,345],{},"axios.get(\"https:\u002F\u002Fipinfo.io\", { httpsAgent: agent }).then((r) => console.log(r.data));\n",[14,347,349],{"id":348},"whitelist-mode-no-credential-extraction","Whitelist mode (no-credential extraction)",[10,351,352,353,356],{},"Once your exit IP is whitelisted, GET a list of ",[26,354,355],{},"IP:port"," proxies and connect directly — no credentials. The whitelist itself can also be managed via API:",[19,358,360],{"className":153,"code":359,"language":155,"meta":28,"style":28},"# Extract: count is required; country=country code\u002FGlobal; protocol=http|socks5; format=txt|json;\n#          session=sticky|random; separator=crlf|br|cr|lf|tab (or st=custom separator)\ncurl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fextract_ip?count=10&country=US&protocol=http&format=json&session=sticky\"\n\n# Whitelist management (userKeyValue = user key, available in the dashboard)\ncurl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fadd-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\ncurl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fdel-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\ncurl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Flists-ip?userName=USERNAME&userKeyValue=USER_KEY\"\n\n# Supported country list\ncurl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fcountry-list\"\n",[26,361,362,367,372,379,383,388,395,402,410,415,421],{"__ignoreMap":28},[159,363,364],{"class":161,"line":162},[159,365,366],{"class":165},"# Extract: count is required; country=country code\u002FGlobal; protocol=http|socks5; format=txt|json;\n",[159,368,369],{"class":161,"line":169},[159,370,371],{"class":165},"#          session=sticky|random; separator=crlf|br|cr|lf|tab (or st=custom separator)\n",[159,373,374,376],{"class":161,"line":193},[159,375,173],{"class":172},[159,377,378],{"class":180}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fextract_ip?count=10&country=US&protocol=http&format=json&session=sticky\"\n",[159,380,381],{"class":161,"line":200},[159,382,197],{"emptyLinePlaceholder":196},[159,384,385],{"class":161,"line":206},[159,386,387],{"class":165},"# Whitelist management (userKeyValue = user key, available in the dashboard)\n",[159,389,390,392],{"class":161,"line":336},[159,391,173],{"class":172},[159,393,394],{"class":180}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fadd-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\n",[159,396,397,399],{"class":161,"line":342},[159,398,173],{"class":172},[159,400,401],{"class":180}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fdel-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\n",[159,403,405,407],{"class":161,"line":404},8,[159,406,173],{"class":172},[159,408,409],{"class":180}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Flists-ip?userName=USERNAME&userKeyValue=USER_KEY\"\n",[159,411,413],{"class":161,"line":412},9,[159,414,197],{"emptyLinePlaceholder":196},[159,416,418],{"class":161,"line":417},10,[159,419,420],{"class":165},"# Supported country list\n",[159,422,424,426],{"class":161,"line":423},11,[159,425,173],{"class":172},[159,427,428],{"class":180}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fcountry-list\"\n",[10,430,431,432,436],{},"See ",[33,433,435],{"href":434},"\u002Fdocs\u002Fusage\u002Fapi-extraction","API Extraction"," for details.",[14,438,440],{"id":439},"key-facts","Key facts",[53,442,443,449,452,457,460,463],{},[56,444,445,446,75],{},"Credentials activate immediately after purchase; when traffic runs out, top up and ",[95,447,448],{},"keep the same credentials with zero downtime",[56,450,451],{},"Unused traffic remains available for the rest of the plan's validity period.",[56,453,454,455,75],{},"To switch IPs mid-session in sticky mode: change the ",[26,456,119],{},[56,458,459],{},"City-level targeting costs nothing extra.",[56,461,462],{},"The service is available only outside mainland China.",[56,464,465,466,471,472,477,478,75],{},"Support: ",[33,467,470],{"href":468,"rel":469},"https:\u002F\u002Ft.me\u002Feproxies",[37],"Telegram"," \u002F ",[33,473,476],{"href":474,"rel":475},"https:\u002F\u002Fdiscord.gg\u002FyzZNxN75",[37],"Discord"," (24\u002F7), email ",[26,479,480],{},"support@eproxies.io",[482,483,484],"style",{},"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);}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 pre.shiki code .sD7c4, html code.shiki .sD7c4{--shiki-default:#D73A49}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}html pre.shiki code .sqxcx, html code.shiki .sqxcx{--shiki-default:#E36209}",{"title":28,"searchDepth":169,"depth":169,"links":486},[487,488,489,490,491],{"id":16,"depth":169,"text":17},{"id":41,"depth":169,"text":42},{"id":149,"depth":169,"text":150},{"id":348,"depth":169,"text":349},{"id":439,"depth":169,"text":440},"This page compresses everything you need to connect to EProxies onto one screen, for AI agents and developers who want fast lookups. Every example runs …","md",null,{},"\u002Fdocs\u002Fen\u002Fagent-reference",{"title":5,"description":492},"docs\u002Fen\u002Fagent-reference","2ia4qy4aOEXt-bY54X4k745OQ5G5gFidsFeL7uh1TEg",1785671055505]