get List the proxies available for purchase (matching the filtering criteria).

/api/client/v1/filters
sale
This request allows you to get a list of all available proxies that match the criteria. You can filter proxies by geo location, operator, type, and protocol using query parameters.

Parameters

geo_country[]

Parameter that filters the response data based on the proxy’s country(-ies) of origin. Country codes should be in ISO 3166-1 alpha-2 format. Multiple entries are allowed.

In: query
Beispiel: RU
Schema:
  • array<string>
    Beispiel: ["RU"]
    Items:
    • string
      Beispiel: "RU"
geo_region[]
Parameter that filters the response data based on the proxy's region(-s) within a country. Multiple entries are allowed.
In: query
Beispiel: Tatarstan Republic
Schema:
  • array<string>
    Beispiel: ["Tatarstan Republic"]
    Items:
    • string
      Beispiel: "Tatarstan Republic"
geo_city[]
Parameter that filters the response data based on the proxy's city(-es). Multiple entries are allowed.
In: query
Beispiel: Kazan
Schema:
  • array<string>
    Beispiel: ["Kazan"]
    Items:
    • string
      Beispiel: "Kazan"
geo_operator[]
Parameter that filters the response data based on the proxy's operator. Multiple entries are allowed.
In: query
Beispiel: megafon
Schema:
  • array<string>
    Beispiel: ["mts"]
    Items:
    • string
      Beispiel: "mts"
type[]
Parameter that filters the response data based on the proxy's type (private or shared). Multiple entries are allowed.
In: query
Beispiel: shared
Schema:
  • array<string>
    Beispiel: ["shared"]
    Items:
    • string
      Beispiel: "shared"
      Enumeration: private shared
protocol[]
Parameter that filters the response data based on the protocol (http or socks5). Multiple entries are allowed.
In: query
Beispiel: http
Schema:
  • array<string>
    Beispiel: ["http"]
    Items:
    • string
      Beispiel: "http"
      Enumeration: http socks5

Antworten

200

OK. Successful response. Returns a list of proxies available for purchase based on the specified criteria.
Content Type:
application/json
  • Schema
  • Example
  • object
    FiltersResponse
    Beispiel: {"geo_country":["RU"],"geo_region":["Tatarstan Republic"],"geo_city":[{"geo_city":"Moscow","geo_country":"RU"}],"geo_operator":[{"geo_operator":"mts","geo_country":"RU"}],"type":["shared"],"protocol":["http"]}
    Eigenschaften:
    • geo_country
      array<string>

      The country of origin of the proxy server. Country codes are in ISO 3166-1 alpha-2 format.

      Beispiel: ["RU"]
      Items:
      • string
        Beispiel: "RU"
    • geo_region
      array<string>
      Region name where server is located
      Beispiel: ["Tatarstan Republic"]
      Items:
      • string
        Beispiel: "Tatarstan Republic"
    • geo_city
      array
      City name where proxy server is located.
      Beispiel: [{"geo_city":"Moscow","geo_country":"RU"}]
      Items:
      • object
        Beispiel: {"geo_city":"Moscow","geo_country":"RU"}
    • geo_operator
      array
      Name of the operator of the proxy server.
      Beispiel: [{"geo_operator":"mts","geo_country":"RU"}]
      Items:
      • object
        Beispiel: {"geo_operator":"mts","geo_country":"RU"}
    • type
      array<string>
      Proxy type
      Beispiel: ["shared"]
      Items:
      • string
        Beispiel: "shared"
        Enumeration: private shared
    • protocol
      array<string>
      Protocol type
      Beispiel: ["http"]
      Items:
      • string
        Beispiel: "http"
        Enumeration: http socks5

401

Unauthorized. Missing or invalid authentication token, please check the Authorization header.
Content Type:
application/json
  • Schema
  • Example
  • object
    ErrorResponse
    Beispiel: {"message":"string","errors":{}}
    Eigenschaften:
    • message
      string
      Erforderlich
      Error message
      Beispiel: "string"
    • errors
      object or null
      Input validation errors
      Beispiel: {}

422

Unprocessable Entity. Invalid filter parameters. Please check the parameters you have specified and try again.
Content Type:
application/json
  • Schema
  • Example
  • object
    ErrorResponse
    Beispiel: {"message":"string","errors":{}}
    Eigenschaften:
    • message
      string
      Erforderlich
      Error message
      Beispiel: "string"
    • errors
      object or null
      Input validation errors
      Beispiel: {}