Proxy-seller
ProxyFree toolsContact sales
  • Documentation
  • PROXY-SELLER
    • Authorization
    • Actions with proxies
      • Retrieve active proxy
      • Export IPs in txt/csv/custom
      • IP replacement
      • Comment on IP
      • Extend proxies
      • Authorizations
        • List of authorizations
        • Create authorization
        • Change authorization
        • Delete authorization
    • Order actions
      • Complete information
      • Calculate the order
      • Place an order
    • Balance
    • Residential proxy
      • Get package information
      • Get all locations
      • Get existing IP list
      • Create list
      • Rename list
      • Change rotation settings
      • Delete list
      • Subaccounts (subusers)
        • Create subuser package
        • Update package
        • Get package information
        • Delete subuser's package
        • Retrieve existing IP lists
        • Create IP list
        • Rename created list
        • Change rotation
        • Delete list
        • Create a special list for API-TOOL
      • Session ID + TTL
        • Create a special list
        • Get all ISP codes
      • Cases (FAQ)
    • API - Changelog
    • SDK PHP
    • SDK NodeJS
    • SDK Phyton
    • SDK Java
    • SDK Golang
  • Mobile CRM
    • Get authorization key
    • Usage guides
      • How to Work with API Reference
      • Host Actions
        • All hosts info
        • List of host modems
        • Change host name
        • Reboot all modems
        • Export modems info
      • Modem Actions
        • Get all modems
        • Change modem IP
        • Set pause on modem
        • Set unpause on modem
        • Reboot modem
        • Change modem rotation
        • Limits on modem
        • Delete limits on modems
        • Delete modem
        • Send a report
      • Modem authorization (users)
        • Create authorization
        • Edit authorization
        • Modem authorizations
        • Authorization info
        • Limit authorization
        • Get limit authorization
        • Delete authorization
      • Modem action links
        • Direct links
        • Create domain
        • Approve domain
        • Edit domain
        • All client domain
        • Domain info
        • Delete domain
    • API Reference
      • Hosts
      • Modems
      • Modem authorization
      • Action links
      • Proxy limit
  • More guides
    • Youtube channel
    • Our blog
  • News, discounts
    • Reddit
    • Discord
    • Telegram
Powered by GitBook
On this page
  • Endpoint:
  • Response:
  • Responses with error in body request:
  • Path parameters:
  • Request body:
  1. PROXY-SELLER
  2. Residential proxy

Create list

This request allows you to create a list.

Endpoint:

POST https://proxy-seller.com/personal/api/v1/{YourApiKey}/resident/list/add

Example:

https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/resident/list/add

Response:

{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "whitelist": "127.0.0.1,192.168.0.1",
    "rotation": "-1 = sticky, 0 = rotation per request, 1..3600 time in seconds",
    "geo": {
      "country": "US",
      "region": "Washington",
      "city": "Garfield",
      "isp": "FIRST-STEP"
    },
    "export": {
      "ports": 10000,
      "ext": "txt"
    }
  },
  "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Tarif not found",
            "code": 0,
            "customData": null
        }
    ]
}

Responses with error in body request:

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Incorrect IP address 0.0.0.0 entered",
            "code": 409,
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP 127.0.0.1 already linked",
            "code": 0,
            "customData": null
        }
    ]
}
Same error may be in case with wrong "region", "city", "isp"!
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Invalid country (region,  city, isp) ISO code",
            "code": 400,
            "customData": null
        },
        {
            "message": "Invalid country ISO code (400)",
            "code": 0,
            "customData": null
        }
    ]
}

Path parameters:

Name
Value
Description

Authorization

<Your_API_Key>

Your personal API key

Request body:

Name
Type
Description

title

String

Name of the list you are creating

whitelist

String

IPs for authorization. Leave blank if you want to authorize with login credentials

geo

object

Add GEO data to your list (country, region, city, ISP)

country

String

region

String

city

String

isp

String

export

object

Here you specify the number of IPs in your list and the export type (port numbers and file format).

ports

Number

Number of IPs (maximum 1000)

ext

String

Type of export

rotation

Number

"rotation: '-1' for no rotation (Sticky), '0' for rotation per request, '1' to '3600' for time-based rotation in seconds

PreviousGet existing IP listNextRename list

Last updated 1 month ago

Country selected from the (Case is important)

Region selected from the (Case is important)

City selected from the (Case is important)

ISP selected from the (Case is important)

GEO database
GEO database
GEO database
GEO database