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.

Five short stepsCopy-paste examplesNo SDK needed
Developer connection
HTTPSOCKS5ROTATE
proxy-client.sh
$ curl -x http://USERNAME:PASSWORD@HOST:PORT https://example.com$ curl "YOUR_PRIVATE_ROTATION_URL"
Host · Port · Username · PasswordSame login after rotation

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

01

Open the connection

Sign in and open the connection for the phone you want to automate.

02

Go to Advanced → API Key

Select Create key and copy the key that starts with jp_. It is shown only once.

03

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 PowerShell

Make 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.