OpenPBN

API reference

JSON over HTTPS. Create a key in your dashboard and send it as a bearer token. Each key can make 60 requests per minute.

Authentication

Send the key in the Authorization header. Keys start with lg_live_. We store only a hash, so a lost key cannot be shown again; revoke it and create a new one.

Authorization: Bearer lg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rate limits and errors

Over 60 requests in a minute returns 429 with a Retry-After header. Errors come back as {"error": {"code": "...", "message": "..."}} with a matching HTTP status: 400 bad input, 401 missing or unknown key, 402 not enough wallet balance, 403 email not verified, 404 not found, 422 refused target.

Retrying requests

Send an Idempotency-Key header with POST /v1/orders. Repeating a request with the same key returns the first order and never charges twice.

Endpoints

GET /api/v1/inventory

Masked sites with DR, referring domains, traffic band, age, state and measurement date, plus counts on sale by language and DR band and by category.

curl https://openpbn.com/api/v1/inventory \
  -H "Authorization: Bearer $LG_KEY"

GET /api/v1/availability

How many links a target domain can buy now for a language, category and DR band, the quote for a quantity, anchor risk and your balance. Parameters: language, category, dr_band, quantity, target_url, anchor, express, anchor_mix.

curl -G https://openpbn.com/api/v1/availability \
  -H "Authorization: Bearer $LG_KEY" \
  -d language=en -d category=finance -d dr_band=30-39 \
  -d quantity=10 -d target_url=https://client.example/page

POST /api/v1/orders

Places an order paid from the wallet. Returns 201 with the order, or 200 with replayed: true when the Idempotency-Key was already used. Links above what is available now are reserved.

curl https://openpbn.com/api/v1/orders \
  -H "Authorization: Bearer $LG_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: client-a-2026-11-17-001" \
  -d '{"target_url":"https://client.example/page",
       "anchor":"household budget planner",
       "language":"en","category":"finance",
       "dr_band":"30-39","quantity":10,
       "express":false,"anchor_mix":true,
       "project_tag":"client-a"}'

GET /api/v1/orders

Your orders, newest first, with live link counts. Optional: limit (1-200), project_tag.

curl "https://openpbn.com/api/v1/orders?project_tag=client-a" \
  -H "Authorization: Bearer $LG_KEY"

GET /api/v1/orders/{id}

One order with every link: masked site code, stage, post URL, dofollow, anchor, indexing status and dates.

curl https://openpbn.com/api/v1/orders/ORDER_ID \
  -H "Authorization: Bearer $LG_KEY"

GET /api/v1/wallet

Balance in cents and the last 50 ledger entries.

curl https://openpbn.com/api/v1/wallet \
  -H "Authorization: Bearer $LG_KEY"