Proxies

Add a proxy

Registers a static proxy. FeelingSurfViewer checks it before any session goes through it, so a new proxy starts with proven false. Exceeding the per-account proxy cap returns 403 proxy_limit_reached; a host and port already on your account returns 422 validation_error.

post/v1/proxies

Request

  • Base URL: https://api.feelingsurf.fr
  • URL: https://api.feelingsurf.fr/v1/proxies
  • Auth: HTTP bearer

Request body

type'http' | 'https' | 'socks5'

The proxy protocol, case-insensitive.

hoststring required

The proxy's public IPv4 or IPv6 address. Hostnames and private addresses are rejected; IPv6 is stored in its compressed form.

portinteger required

The proxy's port.

usernamestring

Username for an http or https proxy. Not allowed with socks5.

passwordstring

Password for an http or https proxy. Not allowed with socks5.

Response

The added proxy.

idinteger

Unique identifier.

type'http' | 'https' | 'socks5'

The proxy protocol.

hoststring

The proxy's public IP address.

portinteger

The proxy's port.

usernamestring nullable

The username sent to the proxy, or null.

has_passwordboolean

Whether a password is stored for the proxy.

enabledboolean

False when you paused the proxy, or when it was switched off after failing (see last_error).

provenboolean

Whether a check through FeelingSurfViewer has confirmed the proxy works at least once. Sessions never go through an unproven proxy, but a proven one can still sit unused, for instance while unanswered is true or shortly after an error.

unansweredboolean

The proxy failed its latest check and is set aside until a new check succeeds.

visitsinteger

Visits made through the proxy.

credits_earntnumber float

Credits earned through the proxy.

last_used_atstring date-time nullable

When a visit last went through the proxy (UTC), or null.

last_errorstring nullable

The latest error code for the proxy, e.g. ERR_PROXY_CONNECTION_FAILED, or null.

last_error_atstring date-time nullable

When last_error happened (UTC), or null.

created_atstring date-time

When the proxy was added (UTC).

Example response

{
  "id": 4821,
  "type": "http",
  "host": "203.0.113.10",
  "port": 8080,
  "username": "exit-eu",
  "has_password": true,
  "enabled": true,
  "proven": true,
  "unanswered": false,
  "visits": 312,
  "credits_earnt": 47.25,
  "last_used_at": "2026-09-12T09:14:03Z",
  "last_error": null,
  "last_error_at": null,
  "created_at": "2026-09-10T18:22:47Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.