Purchasing Static Residential Proxies via the API

This guide demonstrates how to programmatically purchase static residential proxies through the Ping Proxies API and then export them to a text file. The process involves:

Getting product information using the catalog endpoint
Creating a checkout for static residential proxies
Exporting the proxies to a text file using list_by_search

Prerequisites

Before you begin, you’ll need:

Your Ping Proxies API keys (both public and private)
Enough credit balance in your account or a payment method set up

Implementation Examples

import requests
import json

# API credentials
API_PUBLIC_KEY = "your_public_key"
API_PRIVATE_KEY = "your_private_key"
BASE_URL = "https://api.pingproxies.com/1.0/public"

# Headers for authentication
headers = {
    "X-API-Public-Key": API_PUBLIC_KEY,
    "X-API-Private-Key": API_PRIVATE_KEY,
    "Content-Type": "application/json"
}

# For this example, we'll directly use US static residential proxies
product_code = "isp_us"  # Change this to your desired product code
quantity = 5  # Change this to your desired quantity

# Step 2: Create a checkout
checkout_url = f"{BASE_URL}/user/checkout/create"
checkout_payload = {
    "product_code": product_code,
    "quantity": quantity,
    "cycle_interval": "month",
    "cycle_interval_count": 1
}

checkout_response = requests.post(checkout_url, headers=headers, json=checkout_payload)

if checkout_response.status_code != 201:
    print(f"Error creating checkout: {checkout_response.status_code}")
    print(checkout_response.text)
    exit(1)

checkout_data = checkout_response.json()
print(f"Checkout created successfully!")

# Extract service ID directly from the response
service_id = checkout_data["data"]["service_id"]
print(f"Service ID: {service_id}")

# In a production environment, you might want to add a polling mechanism
# to check if the service is active before proceeding
# time.sleep(10)  # Simple wait - replace with polling in production

# Step 3: Export proxies to a text file using list_by_search
export_url = f"{BASE_URL}/user/proxy/list_by_search"
export_params = {
    "service_id": service_id,
    "list_format": "http",  # Format: http, socks5, socks5h, or standard
    "list_protocol": "http",  # Protocol: http or socks5
    "list_authentication": "username_and_password"  # Authentication type
}

export_response = requests.get(export_url, headers=headers, params=export_params)

if export_response.status_code != 200:
    print(f"Error exporting proxies: {export_response.status_code}")
    print(export_response.text)
    exit(1)

export_data = export_response.json()
proxies = export_data["data"]

# Write proxies to a text file
filename = f"{product_code}_proxies.txt"
with open(filename, "w") as f:
    for proxy in proxies:
        f.write(f"{proxy}\n")

print(f"Successfully exported {len(proxies)} proxies to {filename}")

Process Overview

Product Selection:
- We directly use the product code for US static residential proxies (“isp_us”)
- You can find available product codes in your dashboard or using the catalog endpoint
Checkout Creation:
- We create a checkout using the product code, quantity, and billing cycle
- The API returns a service ID which we’ll use to access our proxies
Proxy Export:
- Once the purchase is complete, we use the list_by_search endpoint to get our proxies
- We filter by service ID and specify the format we want (HTTP in this example)
- Finally, we save the proxies to a text file

Additional Considerations

In a production environment, implement a polling mechanism to check if the service is active before attempting to export proxies
The default proxy user credentials are used in this example
You may want to create a custom proxy user for better organization and access control

On this page

Prerequisites
Implementation Examples
Process Overview
Additional Considerations

This guide demonstrates how to programmatically purchase static residential proxies through the Ping Proxies API and then export them to a text file. The process involves:

Getting product information using the catalog endpoint
Creating a checkout for static residential proxies
Exporting the proxies to a text file using list_by_search

Prerequisites

Before you begin, you’ll need:

Your Ping Proxies API keys (both public and private)
Enough credit balance in your account or a payment method set up

Implementation Examples

import requests
import json

# API credentials
API_PUBLIC_KEY = "your_public_key"
API_PRIVATE_KEY = "your_private_key"
BASE_URL = "https://api.pingproxies.com/1.0/public"

# Headers for authentication
headers = {
    "X-API-Public-Key": API_PUBLIC_KEY,
    "X-API-Private-Key": API_PRIVATE_KEY,
    "Content-Type": "application/json"
}

# For this example, we'll directly use US static residential proxies
product_code = "isp_us"  # Change this to your desired product code
quantity = 5  # Change this to your desired quantity

# Step 2: Create a checkout
checkout_url = f"{BASE_URL}/user/checkout/create"
checkout_payload = {
    "product_code": product_code,
    "quantity": quantity,
    "cycle_interval": "month",
    "cycle_interval_count": 1
}

checkout_response = requests.post(checkout_url, headers=headers, json=checkout_payload)

if checkout_response.status_code != 201:
    print(f"Error creating checkout: {checkout_response.status_code}")
    print(checkout_response.text)
    exit(1)

checkout_data = checkout_response.json()
print(f"Checkout created successfully!")

# Extract service ID directly from the response
service_id = checkout_data["data"]["service_id"]
print(f"Service ID: {service_id}")

# In a production environment, you might want to add a polling mechanism
# to check if the service is active before proceeding
# time.sleep(10)  # Simple wait - replace with polling in production

# Step 3: Export proxies to a text file using list_by_search
export_url = f"{BASE_URL}/user/proxy/list_by_search"
export_params = {
    "service_id": service_id,
    "list_format": "http",  # Format: http, socks5, socks5h, or standard
    "list_protocol": "http",  # Protocol: http or socks5
    "list_authentication": "username_and_password"  # Authentication type
}

export_response = requests.get(export_url, headers=headers, params=export_params)

if export_response.status_code != 200:
    print(f"Error exporting proxies: {export_response.status_code}")
    print(export_response.text)
    exit(1)

export_data = export_response.json()
proxies = export_data["data"]

# Write proxies to a text file
filename = f"{product_code}_proxies.txt"
with open(filename, "w") as f:
    for proxy in proxies:
        f.write(f"{proxy}\n")

print(f"Successfully exported {len(proxies)} proxies to {filename}")

Process Overview

Product Selection:
- We directly use the product code for US static residential proxies (“isp_us”)
- You can find available product codes in your dashboard or using the catalog endpoint
Checkout Creation:
- We create a checkout using the product code, quantity, and billing cycle
- The API returns a service ID which we’ll use to access our proxies
Proxy Export:
- Once the purchase is complete, we use the list_by_search endpoint to get our proxies
- We filter by service ID and specify the format we want (HTTP in this example)
- Finally, we save the proxies to a text file

Additional Considerations

In a production environment, implement a polling mechanism to check if the service is active before attempting to export proxies
The default proxy user credentials are used in this example
You may want to create a custom proxy user for better organization and access control

On this page

Prerequisites
Implementation Examples
Process Overview
Additional Considerations

​Prerequisites

​Implementation Examples

​Process Overview

​Additional Considerations

Product Updates

​Prerequisites

​Implementation Examples

​Process Overview

​Additional Considerations

Prerequisites

Implementation Examples

Process Overview

Additional Considerations

Prerequisites

Implementation Examples

Process Overview

Additional Considerations