Build API quickstart: your first request
Go from a new API key to an automated IP rotation in a few minutes. Every step has a copyable curl, Python and Node.js version.
$ curl -x http://USERNAME:PASSWORD@HOST:PORT https://example.com$ curl "YOUR_PRIVATE_ROTATION_URL"Before you start
- A Build account with a connection and a paired Android phone showing Proxy ON. Not there yet? Follow the installation guide first.
- curl, Python 3 with
requests, or Node.js 18 or newer. - Two minutes in the dashboard to create a key.
Create a connection key
Open the connection
Sign in and open the connection for the phone you want to automate.
Go to Advanced → API Key
Select Create key and copy the key that starts with jp_. It is shown only once.
Save it as an environment variable
export JP_API_KEY="jp_YOUR_CONNECTION_KEY" # macOS / Linux
$env:JP_API_KEY = "jp_YOUR_CONNECTION_KEY" # Windows PowerShellMake your first request
curl -s https://build.jesusproxy.com/api/connection/status -H "Authorization: Bearer $JP_API_KEY"import os, requests
API = "https://build.jesusproxy.com/api"
H = {"Authorization": f"Bearer {os.environ['JP_API_KEY']}"}
r = requests.get(f"{API}/connection/status", headers=H, timeout=20)
print(r.status_code, r.json())const API = "https://build.jesusproxy.com/api";
const H = { Authorization: `Bearer ${process.env.JP_API_KEY}` };
const r = await fetch(`${API}/connection/status`, { headers: H });
console.log(r.status, await r.json());You should see "online": true and the phone’s current exitIp. A 401 means the key is missing or has been replaced by a newer one.
Read your access points
curl -s https://build.jesusproxy.com/api/connection/proxies -H "Authorization: Bearer $JP_API_KEY"import os, requests
API = "https://build.jesusproxy.com/api"
H = {"Authorization": f"Bearer {os.environ['JP_API_KEY']}"}
for p in requests.get(f"{API}/connection/proxies", headers=H, timeout=20).json():
print(p["protocol"], f'{p["host"]}:{p["port"]}', p["login"])const API = "https://build.jesusproxy.com/api";
const H = { Authorization: `Bearer ${process.env.JP_API_KEY}` };
const list = await (await fetch(`${API}/connection/proxies`, { headers: H })).json();
for (const p of list) console.log(p.protocol, `${p.host}:${p.port}`, p.login);Each item has the host, port, login and password your tools need.
Rotate the IP
curl -s -X POST https://build.jesusproxy.com/api/connection/rotate-ip -H "Authorization: Bearer $JP_API_KEY"
curl -s https://build.jesusproxy.com/api/connection/rotation-status/ -H "Authorization: Bearer $JP_API_KEY"import os, requests
API = "https://build.jesusproxy.com/api"
H = {"Authorization": f"Bearer {os.environ['JP_API_KEY']}"}
r = requests.post(f"{API}/connection/rotate-ip", headers=H, timeout=20)
print(r.status_code, r.json()["message"])const API = "https://build.jesusproxy.com/api";
const H = { Authorization: `Bearer ${process.env.JP_API_KEY}` };
const r = await fetch(`${API}/connection/rotate-ip`, { method: "POST", headers: H });
console.log(r.status, (await r.json()).message);200 means the phone is switching networks now. 503 means it is offline and will rotate once it is back.
Put it together: rotate between jobs
import os, requests
API = "https://build.jesusproxy.com/api"
H = {"Authorization": f"Bearer {os.environ['JP_API_KEY']}"}
import time
def exit_ip():
return requests.get(f"{API}/connection/status", headers=H, timeout=20).json().get("exitIp")
def rotate(timeout=150):
before = exit_ip()
r = requests.post(f"{API}/connection/rotate-ip", headers=H, timeout=20)
if r.status_code == 503:
raise RuntimeError("phone offline")
deadline = time.time() + timeout
while time.time() < deadline:
time.sleep(5)
ip = exit_ip()
if ip and ip != before:
return ip
return exit_ip() # the carrier can hand back the same IP; that is normal
for job in ["job-1", "job-2", "job-3"]:
print(job, "running from", exit_ip())
# ... do the work through your proxy here ...
print("rotated to", rotate())const API = "https://build.jesusproxy.com/api";
const H = { Authorization: `Bearer ${process.env.JP_API_KEY}` };
const sleep = ms => new Promise(r => setTimeout(r, ms));
const exitIp = async () => (await (await fetch(`${API}/connection/status`, { headers: H })).json()).exitIp;
async function rotate(timeoutMs = 150_000) {
const before = await exitIp();
const r = await fetch(`${API}/connection/rotate-ip`, { method: "POST", headers: H });
if (r.status === 503) throw new Error("phone offline");
for (const end = Date.now() + timeoutMs; Date.now() < end; ) {
await sleep(5000);
const ip = await exitIp();
if (ip && ip !== before) return ip;
}
return exitIp();
}
for (const job of ["job-1", "job-2", "job-3"]) {
console.log(job, "running from", await exitIp());
// ... do the work through your proxy here ...
console.log("rotated to", await rotate());
}Next, read the full API reference for access points, stats and VPN profiles, or the IP rotation guide for timing advice.
Ready to script your own proxy?
Pair an Android phone, create a connection key and run the example above.