API Documentation

Complete reference documentation for the ProxyStacks API. Learn how to integrate proxy services into your applications with our comprehensive guides and examples.

View Endpoints View Examples

Base URL

https://api.proxystacks.com

Authentication

All API requests require an API key to be included in the headers:

X-API-Key: your_api_key_here

You can obtain your API key from your account dashboard after logging in.

API Endpoints

GET/proxies

List Proxies

Returns a paginated list of available proxies with filtering options.

Parameters

Name	Type	Required	Description
page	number	No	Page number for pagination
page_size	number	No	Number of items per page
protocol	string	No	Filter by protocol (e.g., http, https, all)
country	string	No	Filter by country code (e.g., US, CN, all)

Example Response

{
  "count": 424,
  "next": "https://api.proxystacks.com/api/v1/web/proxies?country=all&page=2&page_size=5&protocol=all",
  "previous": null,
  "results": [
    {
      "protocol": "https",
      "host": "3.21.101.158",
      "port": 80,
      "country": "US",
      "country_name": "United States",
      "speed": "30924KB/s",
      "last_check": "2024-12-06 12:52:31"
    }
  ]
}

Rate Limiting

The API is rate limited to:

•100 requests per minute for free tier
•1000 requests per minute for premium tier

Exceeding these limits will result in a 429 Too Many Requests response. Consider upgrading to our premium tier for higher limits.