Enterprise API

Authentication

Authorization: Bearer <NETSHARE_API_KEY>

Core Endpoints

EndpointDescription
POST /v1/network/requestExecute a network exit request
POST /v1/network/session/openCreate a sticky session
POST /v1/network/session/rotateRotate the network exit
GET /v1/network/usageUsage and quality metrics

Request Fields

FieldTypeDescription
target_urlstringTarget URL
zonestringExit pool
geo.countrystringCountry code
geo.citystringCity slug
geo.asnnumberSpecific ISP ASN
session.modeenumrotate / sticky
session.ttl_secondsnumberSticky session duration
import axios from "axios";

const resp = await axios.post(
  "https://api.netshare.ai/v1/network/request",
  {
    target_url: "https://example.com",
    zone: "residential-global",
    geo: { country: "US", city: "new_york" },
    session: { mode: "sticky", ttl_seconds: 180 }
  },
  { headers: { Authorization: `Bearer ${process.env.NETSHARE_API_KEY}` } }
);
Next: Account Management API