Goldmine
Import

Import a proxy list into a pool

POST
/proxies.v1.Proxies/ImportProxyList

Turns an uploaded list of proxies into ready-to-use sessions in one call. It creates a new provider-less pool by name and inserts one session per row directly into it - there is no provider and no existing-pool option. Each row is processed independently and the response reports per-row success or error.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/proxies.v1.Proxies/ImportProxyList" \  -H "Content-Type: application/json" \  -d '{    "poolName": "imported-proxies",    "rows": [      {        "scheme": "http",        "host": "203.0.113.10",        "port": 8080,        "username": "u1",        "password": "p1"      },      {        "scheme": "socks5",        "host": "203.0.113.11",        "port": 1080      }    ]  }'
{
  "poolId": "AY+MISIifMyN3T09PT09PQ==",
  "results": [
    {
      "sessionId": "AY+MIjMzfu6P/05OTk5OTg=="
    },
    {
      "error": {
        "code": "IMPORT_PROXY_LIST_ERROR_CODE_INVALID",
        "message": "invalid host"
      }
    }
  ]
}

{
  "code": "failed_precondition",
  "message": "The request cannot be carried out in the current system state."
}

{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "already_exists",
  "message": "The resource already exists."
}
{
  "code": "resource_exhausted",
  "message": "The request was rate limited. Slow down and retry later."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}
{
  "code": "unavailable",
  "message": "The service is temporarily unavailable. Retry with backoff."
}

ListProxyAssignments

Returns the ids of legacy proxy assignments in your workspace, optionally filtered by pool, proxy, or account name. Results are bare ids rather than fully hydrated assignments; fetch each one with GetProxyAssignment. Results are paginated; pass an empty cursor for the first page and follow the returned cursor for subsequent pages.

QueryProxyUsage

Returns the proxy bandwidth ledger over an inclusive date range, optionally narrowed by provider, pool, session, or account. Each row is a daily total of requests, errors, and bytes transferred. Results are paginated; follow the returned cursor for subsequent pages.