White Lands API

Generate white pages programmatically — create an order, poll its status, download the ZIP. Same engine, same prices as the website. Billed from your prepaid balance.

1. Get an API key

Keys are created from your account. You must top up your balance to at least $10 to create a key. Each generation is then charged from that balance (1 credit = $1) — no balance, nothing is generated.

2. Authentication

Send your key as a Bearer token on every /api/v1 request:

Authorization: Bearer wl_live_xxxxxxxxxxxxxxxxxxxx

3. Generate

curl -X POST https://white-lands.com/api/v1/generate \
 -H "Authorization: Bearer $WL_KEY" \
 -H "Content-Type: application/json" \
 -d '{"page_type":"landing","pages":3,"count":5,"niche":"solar","geo":"US","target_lang":"en"}'

Response:

{
 "ok": true,
 "order_id": 412,
 "cost_usd": 23,
 "balance_after_usd": 77,
 "count": 5,
 "status": "queued",
 "poll": "/api/v1/orders/412"
}

4. Check status & download

Poll every ~20–30s. When status is done, downloads holds signed ZIP links (valid 30 days) for all expected_lands. partial means some are ready (ready_lands of expected_lands) and the rest is being finished — download what is there and keep polling. cancelled and failed are final.

curl https://white-lands.com/api/v1/orders/412 \
 -H "Authorization: Bearer $WL_KEY"

{
 "order_id": 412,
 "status": "done", // queued | generating | partial | done | failed | cancelled
 "expected_lands": 1,
 "ready_lands": 1,
 "downloads": [
 {"slug":"solar-grid-x9", "url":"https://white-lands.com/api/delivery/solar-grid-x9?t=..."}
 ]
}

5. Balance

curl https://white-lands.com/api/v1/balance -H "Authorization: Bearer $WL_KEY"
{ "balance_usd": 77 }

Full example (Python)

import requests, time
H = {"Authorization": "Bearer " + WL_KEY}
B = "https://white-lands.com"

r = requests.post(f"{B}/api/v1/generate",
 headers=H, json={"page_type":"landing","pages":3,"count":5,"geo":"US"}).json()
oid = r["order_id"]
print("order", oid, "cost $", r["cost_usd"])

while True:
 s = requests.get(f"{B}/api/v1/orders/{oid}", headers=H).json()
 print(s["status"])
 if s["status"] in ("done","failed","cancelled"): break
 time.sleep(30)

for d in s.get("downloads", []):
 print("download:", d["url"])

Errors