Introducing the Ping Proxies API

Today we are delighted to announce general availability of the Ping Proxies REST API—a fully-featured programmatic interface which allows you to interact with our platform and proxy networks.

The API enables your systems to sync proxies, generate residential endpoints, provision new services, and manage proxy users in your backend systems, data collection pipelines, or custom applications. With predictable JSON endpoints and simple key-based authentication, you can now automate proxy management end-to-end across your technology stack.

Along with the API, we've developed comprehensive documentation that provides everything you need to quickly implement and leverage these capabilities, regardless of your preferred programming language. Whether you're implementing in Python, Go, Rust, JavaScript, PHP, or other languages, our documentation includes detailed guides and code examples to ensure an easy integration process.

Checkout the API and documentation now:

• Documentation
• Create API Key
• View API Analytics

Why provide an API?

We developed our REST API in direct response to our client needs. Over the past few years, we've had various customers, big and small, consistently request capabilities that can only be served via an API, these include:

• Agentic AI partners wanting automated proxy list syncing with their infrastructure
• Web-scrapers wanting robust analytics endpoints to power their Grafana dashboards
• Resellers wanting the ability to white label our services and sell them on their own platforms

Now... they're ALL covered. The API addresses these requirements by delivering a unified interface that supports deep integration with our platform. By providing programmatic access to the same functionality that powers our customer dashboard, we're giving developers and clients the tools to build what they want and need without the need to tussle for space on our product roadmap.

Core Capabilities

Comprehensive proxy search: Filter inventory by country, ASN, subnet, IP address, proxy type, service ID…and much more

• Residential generation: Create sticky or rotating residential lists tied to any proxy user
• Proxy User Management: Create, edit, and delete proxy users, rotate passwords, set bandwidth limits, and switch between user/pass and IP authentication
• Real-time analytics: Retrieve detailed traffic usage across all networks broken down by website and proxy user
• Object metadata: Attach arbitrary key–value pairs to customers, services, proxy users, and proxies for internal tracking or reseller billing
• Programmatic purchasing: Generate quotes and complete check-outs entirely through the API, enabling unattended scaling
• Search Operators: Powerful filtering with min_, max_, like_, not_, and exists_ operators to create precise queries across all resources

All capabilities are documented with sample requests in the Examples and API Reference sections of the documentation.

Simple API Key Management

Create and manage API keys directly from your dashboard with just a few clicks. Label your keys for easy tracking, view their creation dates, and delete them when they're no longer needed. You can create multiple keys for different applications or team members and rotate them regularly for better security without disrupting your services.

API Analytics Tracking

See exactly how your code is using our API with detailed request logs and usage statistics. Track all your API calls including endpoints, response codes, and timestamps in one place. The analytics dashboard shows your request volume over time and lists every API call with its complete details, making it easy to monitor performance and troubleshoot any issues with your integration.

Searching proxies with precision

The route GET /proxy/search accepts an extensive filter set. To return AT&T United States ISP proxy, a minimal request looks like:

curl --request GET \
  --url 'https://api.pingproxies.com/1.0/public/user/proxy/search?proxy_type=isp&asn_id=7029&country_id=us' \
  --header 'X-API-Public-Key: <public_key>' \
  --header 'X-API-Private-Key: <private_key>

Additional parameters—such as city_id, subnet_id, and metadata[key]—let you filter results further. Pagination, operators and sorting controls (not_, like_, min_, max_, page, per_page, sort_by) are consistent across the entire API, so the same logic works for every collection resource.​

Generating residential proxies

The endpoint GET /residential/list supports country targeting, city targeting, session configuration, proxy user selection and protocol configuration.

curl --request GET\
  --url 'https://api.pingproxies.com/1.0/public/user/residential/generate?proxy_user_id=stevejobs&country_id=us' \
  --header 'X-API-Public-Key: <public_key>' \
  --header 'X-API-Private-Key: <private_key>'

Managing proxy users

Proxy users resources are made up of credentials, bandwidth limits, and service restrictions. Typical operations include:

• POST /proxy_user/create: Create a user with optional IP address whitelist, metadata, bandwidth limits, and service restrictions.
• PATCH /proxy_user/edit: Rotate passwords, toggle authentication mode, or adjust a bandwidth limits.
• DELETE /proxy_user/delete: Revoke access immediately.

Applying metadata and supporting resellers

Metadata capabilities allow you to attach custom attributes to your proxy user and service resources, making it ideal for tracking proxy users and services against internal data.

Resellers can track internal customer identifiers, organizations can associate resources with internal departments or projects, and teams can create custom grouping schemes.

You can easily search and filter resources based on metadata values using operators like exact match, minimum/maximum value comparisons, substring searches, and existence checks - retaining deep search capabilities even on your metadata fields.

Programmatic purchasing

A three-step checkout flow allows unattended scaling:

• GET /product/catalog: Retrieve available products.
• POST /checkout/quote: Build a quote specifying quantity, duration, or bandwidth.
• POST /checkout/create: Purchase a service and receive the proxies back from a single request.

Developer-first documentation

The documentation site is validated continuously and accompanied by an OpenAPI specification. Features include:

• Multi-language code snippets in Python, JavaScript/TypeScript, PHP, Go, and Java.
• Try It buttons that execute requests against a sandbox environment to demonstrate real responses.
• Structured error definitions and API request IDs will help you troubleshoot your integration
• Key-pair management via dashboard or API, supporting rotation and least-privilege practices.
• Live request logging visible in the dashboard, simplifying debugging.​

Conclusion

The Ping Proxies API puts complete control of your proxy infrastructure into your code. It offers the same functionality as our dashboard but in a format you can integrate directly into your systems and automation workflows.

Whether you need to sync proxies with your infrastructure, send analytics to your monitoring tools, or build a custom proxy service under your own brand, the API gives you the tools to do it without manual intervention.

We've focused on making the API practical and straightforward to use with clear documentation and examples in multiple programming languages. Generate your keys today, try the example calls, and start building proxy management directly into your applications.

We'll continue adding features based on your feedback, so let us know what you need at [email protected]