Official SDKs
Python, Node.js, and Go clients for buyer Connect/bulk and seller/provider APIs.
Shared surface (v0.3+): session intents, order credentials, bulk pools, and seller/provider tokens, nodes, listings, and earnings.
| Language | Package | Install |
|---|---|---|
| Python | proxyhubb | pip install proxyhubb |
| Node.js | @proxyhubb/sdk | npm install @proxyhubb/sdk |
| Go | module | go get github.com/samuel-1-avson/ProxySocialHub/sdks/[email protected] |
| Provider CLI | @proxyhubb/provider / proxyhubb-provider | see Provider CLI |
There is no separate “seller CLI” — sellers run the Provider CLI / node and automate listings via these SDKs.
Defaults
| Setting | Default | Override |
|---|---|---|
| Control API | https://api.proxyhubb.com | constructor / base_url / baseURL |
| Buyer proxy | proxy.proxyhubb.com:8090 | PROXYHUBB_PROXY_ENDPOINT |
Auth reminder
| Credential | Flows |
|---|---|
JWT (Authorization: Bearer) | Session intents, order credentials, seller/provider APIs |
| Provider token (same Bearer header) | Tokens, nodes, listings, earnings |
API key (X-API-Key / phub_… / pk_…) | Bulk pools only — not provider routes |
Mixing these up is the most common integration mistake: intent create requires JWT; pools are designed around API keys; seller ops need JWT or provider token.
Pick a path
- Quick Connect — JWT → create intent → proxy with
session-intent— Python / Node / Go - Marketplace order — buy →
get*OrderCredentials→ CONNECT username/password - Bulk pools — API key →
createPool→ pool proxy URLs — guide - Seller automation — JWT or provider token → tokens / nodes / listings / earnings
- Run a node — Provider CLI (
npx @proxyhubb/provideror binaries)
Version pins: Changelog & SDK matrix.
Common errors (all SDKs)
| Symptom | Fix |
|---|---|
401 / unauthorized | Check JWT expiry, provider token, or API key value |
| Intent create fails with API key | Pass access_token / accessToken, not only phub_… |
Provider route fails with pk_ key | Use Bearer JWT or provider token — buyer API keys are rejected |
| Proxy URL wrong host | Set PROXYHUBB_PROXY_ENDPOINT or pass endpoint into the client |
| HTTPS requests hang / 501 | Ensure the HTTP client uses CONNECT (SDK helpers do) |