Bitping Developer API

Not signed up yet? Get started for as little as $5/month

This documentation covers the various job types available through the Customer Jobs API. Each job type allows you to perform specific network tests from different locations and ISPs.

OpenAPI Documentation

For a comprehensive and interactive view of our API, please refer to our OpenAPI specification:

Bitping API OpenAPI Specification

For the best experience, we recommend viewing the specification in an OpenAPI viewer such as Swagger UI or ReDoc. You can also import the URL into Yaak, Postman, Insomnia or your favourite desktop API client.

DNS Lookup

Perform a DNS lookup for specified hostnames.

Endpoint

POST /jobs/customer/dns

Request Body

Field	Type	Description
hostnames	string[]	Array of hostnames to lookup
countryCode	string (optional)	Filter nodes by country code
ispRegex	string (optional)	Filter nodes by ISP regex
residential	string (optional)	Filter by residential nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
proxy	string (optional)	Filter by proxy nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
mobile	string (optional)	Filter by mobile nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
configuration	object (optional)	DNS-specific configuration

Configuration Object

Field	Type	Description
dnsServers	string[] (optional)	List of DNS servers to use (e.g. ‘8.8.8.8:53’, ‘1.1.1.1:53’)
lookupTypes	string[] (optional)	Types of DNS lookups to perform (e.g., “MX”, “NS”, “IP”, “TXT”, “SOA”, “SRV”, “TLSA”)

Response

Returns the DNS lookup results along with node information.

{
  nodeInfo: {
    operatingSystem: string;
    isp: string;
    mobile: boolean;
    proxy: boolean;
    regionName: string;
    countryCode: string;
    lat: number;
    lon: number;
  };
  results: Array<{
    endpoint: string;
    duration: number;
    error?: string;
    result?: {
      mx: string[];
      ns: string[];
      ips: string[];
      txt: string[];
      soa: string[];
      srv: string[];
      tlsa: string[];
      dnsServers: string[];
    };
  }>;
}

HTTP Request

Perform an HTTP request to specified hostnames.

Endpoint

POST /jobs/customer/http/{method}

Parameters

Parameter	Description
method	The HTTP method to use (e.g., GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD)

Request Body

Field	Type	Description
hostnames	string[]	Array of hostnames to lookup
countryCode	string (optional)	Filter nodes by country code
ispRegex	string (optional)	Filter nodes by ISP regex
residential	string (optional)	Filter by residential nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
proxy	string (optional)	Filter by proxy nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
mobile	string (optional)	Filter by mobile nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
configuration	object (optional)	DNS-specific configuration

Configuration Object

Field	Type	Description
headers	object (optional)	Key-value pairs of HTTP headers
regex	string (optional)	Regex pattern to match in the response
statusCodes	number[] (optional)	Expected status codes
body	string (optional)	Request body for POST, PUT, PATCH requests
returnBody	boolean (optional)	Whether to return the response body

Response

Returns the HTTP response along with node information.

{
  nodeInfo: {
    operatingSystem: string;
    isp: string;
    mobile: boolean;
    proxy: boolean;
    regionName: string;
    countryCode: string;
    lat: number;
    lon: number;
  };
  results: Array<{
    endpoint: string;
    duration: number;
    error?: string;
    result?: {
      statusCode: number;
      bodyHash: string;
      matches: string[];
      headers: Record<string, string>;
      body?: string;
    };
  }>;
}

ICMP Ping

Perform a ping test to specified hostnames.

Endpoint

POST /jobs/customer/ping/icmp

Request Body

Field	Type	Description
hostnames	string[]	Array of hostnames to lookup
countryCode	string (optional)	Filter nodes by country code
ispRegex	string (optional)	Filter nodes by ISP regex
residential	string (optional)	Filter by residential nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
proxy	string (optional)	Filter by proxy nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
mobile	string (optional)	Filter by mobile nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
configuration	object (optional)	DNS-specific configuration

Configuration Object

Field	Type	Description
attempts	number (optional)	Number of ping attempts
payloadSize	number (optional)	Size of the ping payload
timeoutMillis	number (optional)	Timeout in milliseconds

Response

Returns the ping results along with node information.

{
  nodeInfo: {
    operatingSystem: string;
    isp: string;
    mobile: boolean;
    proxy: boolean;
    regionName: string;
    countryCode: string;
    lat: number;
    lon: number;
  };
  results: Array<{
    endpoint: string;
    duration: number;
    error?: string;
    result?: {
      avg: number;
      max: number;
      min: number;
      stdDev: number;
      ipAddress: string;
      packetLoss: number;
      packetsRecv: number;
      packetsSent: number;
      trips: number;
      attempts: number;
    };
  }>;
}

HLS Stream Test

Perform an HLS (HTTP Live Streaming) test on specified stream URLs.

Endpoint

POST /jobs/customer/hls

Request Body

Field	Type	Description
hostnames	string[]	Array of hostnames to lookup
countryCode	string (optional)	Filter nodes by country code
ispRegex	string (optional)	Filter nodes by ISP regex
residential	string (optional)	Filter by residential nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
proxy	string (optional)	Filter by proxy nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
mobile	string (optional)	Filter by mobile nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
configuration	object (optional)	DNS-specific configuration

Configuration Object

Field	Type	Description
headers	object (optional)	Key-value pairs of HTTP headers

Response

Returns the HLS stream test results along with node information.

{
  nodeInfo: {
    operatingSystem: string;
    isp: string;
    mobile: boolean;
    proxy: boolean;
    regionName: string;
    countryCode: string;
    lat: number;
    lon: number;
  };
  results: Array<{
    endpoint: string;
    duration: number;
    error?: string;
    result?: {
      master: {
        file: string;
        downloadMetrics: {
          size: number;
          timeMs: number;
          bytesPerSecond: number;
        };
        metrics: {
          dnsResolveDurationMs?: number;
          tcpConnectDurationMs: number;
          tlsHandshakeDurationMs?: number;
          httpGetSendDurationMs: number;
          httpTtfbDurationMs: number;
        };
        renditions: Array<{
          file: string;
          downloadMetrics: {
            size: number;
            timeMs: number;
            bytesPerSecond: number;
          };
          metrics: {
            dnsResolveDurationMs?: number;
            tcpConnectDurationMs: number;
            tlsHandshakeDurationMs?: number;
            httpGetSendDurationMs: number;
            httpTtfbDurationMs: number;
          };
          contentFragmentMetrics: Array<{
            file: string;
            contentFragmentDurationSecs: number;
            metrics: {
              dnsResolveDurationMs?: number;
              tcpConnectDurationMs: number;
              tlsHandshakeDurationMs?: number;
              httpGetSendDurationMs: number;
              httpTtfbDurationMs: number;
            };
            downloadMetrics: {
              size: number;
              timeMs: number;
              bytesPerSecond: number;
            };
            downloadRatio: number;
          }>;
          targetDurationSecs: number;
          discontinuitySequence: number;
          resolution: string;
          bandwidth: number;
        }>;
      };
      rendition: {
        file: string;
        downloadMetrics: {
          size: number;
          timeMs: number;
          bytesPerSecond: number;
        };
        metrics: {
          dnsResolveDurationMs?: number;
          tcpConnectDurationMs: number;
          tlsHandshakeDurationMs?: number;
          httpGetSendDurationMs: number;
          httpTtfbDurationMs: number;
        };
        contentFragmentMetrics: Array<{
          file: string;
          contentFragmentDurationSecs: number;
          metrics: {
            dnsResolveDurationMs?: number;
            tcpConnectDurationMs: number;
            tlsHandshakeDurationMs?: number;
            httpGetSendDurationMs: number;
            httpTtfbDurationMs: number;
          };
          downloadMetrics: {
            size: number;
            timeMs: number;
            bytesPerSecond: number;
          };
          downloadRatio: number;
        }>;
        targetDurationSecs: number;
        discontinuitySequence: number;
        resolution: string;
        bandwidth: number;
      };
    };
  }>;
}

Traceroute

Trace the network path to a destination hop-by-hop, measuring per-hop latency and packet loss. Supports ICMP, UDP, and TCP probes with three multipath strategies (CLASSIC, PARIS, DUBLIN).

Endpoint

POST /jobs/customer/traceroute

Request Body

Field	Type	Description
hostnames	string[]	Array of hostnames or IPs to trace
countryCode	string (optional)	Filter nodes by country code
ispRegex	string (optional)	Filter nodes by ISP regex
residential	string (optional)	Filter by residential nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
proxy	string (optional)	Filter by proxy nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
mobile	string (optional)	Filter by mobile nodes: “ALLOWED”, “DENIED”, or “REQUIRED”
configuration	object (optional)	Traceroute-specific configuration

Configuration Object

Field	Type	Description
protocol	”ICMP” \| “UDP” \| “TCP” (optional)	Probe protocol. Defaults to `ICMP`
multipathStrategy	”CLASSIC” \| “PARIS” \| “DUBLIN” (optional)	Multipath strategy. `PARIS` and `DUBLIN` require privileged mode + UDP. Defaults to `CLASSIC`
maxHops	number (optional)	Maximum hops to probe (1–255)
firstTtl	number (optional)	TTL of the first probe (1–255)
queriesPerHop	number (optional)	Number of probes per hop
timeoutMs	number (optional)	Per-probe timeout in milliseconds
packetSize	number (optional)	Probe packet size in bytes
port	number (optional)	Destination port for UDP/TCP probes (1–65535)
resolveHostnames	boolean (optional)	Reverse-DNS each hop’s IP
disableIpv6Upgrade	boolean (optional)	Skip the DNS64/NAT64 IPv6 fallback used on IPv4-only mobile carriers

Response

Returns the traceroute results along with node information.

{
  nodeInfo: {
    operatingSystem: string;
    isp: string;
    mobile: boolean;
    proxy: boolean;
    regionName: string;
    countryCode: string;
    lat: number;
    lon: number;
  };
  results: Array<{
    endpoint: string;
    duration: number;
    error?: string;
    result?: {
      protocol: "ICMP" | "UDP" | "TCP";
      multipathStrategy: "CLASSIC" | "PARIS" | "DUBLIN";
      targetIp: string;
      reached: boolean;
      hops: Array<{
        ttl: number;
        ipAddress?: string;
        hostname?: string;
        sent: number;
        received: number;
        packetLoss: number;
        avgMs?: number;
        minMs?: number;
        maxMs?: number;
        stdDevMs?: number;
      }>;
    };
  }>;
}

Customers

Nodes

Customers

Nodes

Bitping Developer API

Not signed up yet? Get started for as little as $5/month

OpenAPI Documentation

DNS Lookup

Endpoint

Request Body

Configuration Object

Response

HTTP Request

Endpoint

Parameters

Request Body

Configuration Object

Response

ICMP Ping

Endpoint

Request Body

Configuration Object

Response

HLS Stream Test

Endpoint

Request Body

Configuration Object

Response

Traceroute

Endpoint

Request Body

Configuration Object

Response

Earn