Subcuentas

Una subcuenta es una etiqueta que añades a tu nombre de usuario de proxy para que el tráfico enviado con ella se contabilice por separado. Usa una por cliente, proyecto o equipo para ver quién usó qué, sin necesidad de planes o credenciales independientes.

Las subcuentas están disponibles en los planes de Residential Proxies.

Uso de una subcuenta

Añade -subaccount-NAME justo después de tu nombre de usuario. Las opciones de targeting y sesión lo siguen como de costumbre:

customer-USERNAME-subaccount-client_a-country-us-sid-abc123-ttl-600:PASSWORD@p.shifter.io:443

curl -x customer-USERNAME-subaccount-client_a:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json

En el panel, abre un plan Residential y ve a Sub-accounts: escribe un nombre y se mostrará el nombre de usuario completo y la línea de proxy, listos para copiar. El Proxy Generator en la misma página también tiene un campo Sub-account para construir endpoints con targeting y sesiones.

Regla	Detalle
Caracteres	De 1 a 16 letras, dígitos o guiones bajos (A-Z, a-z, 0-9, _). Sin guiones: el guion separa las opciones del nombre de usuario
Mayúsculas y minúsculas	Distingue mayúsculas de minúsculas: Client_A y client_a son dos subcuentas
Alcance	Por plan: el mismo nombre en dos planes son dos subcuentas distintas
Creación	No es necesaria. Una subcuenta aparece unos minutos después de su primera solicitud
Retención	Se mantiene listada hasta 365 días después de su última solicitud. Un nombre reutilizado dentro de ese periodo continúa con su historial anterior

Precaución

Las subcuentas sirven solo para seguimiento. Usan la contraseña y el ancho de banda de tu plan, y no se aplica ningún límite por subcuenta: si revendes acceso, aplica límites y facturación en tu propia plataforma usando las cifras de abajo. El tráfico de subcuenta no es una cifra de facturación; el uso de tu plan sí lo es.

En el panel, la página del plan muestra cada subcuenta con su tráfico de hoy, los últimos 7 días y los últimos 30 días, y el gráfico de tráfico de la página del plan y el panel de control pueden alternar entre la cuenta principal y cualquier subcuenta.

Autenticación

Ambos endpoints toman el api_token de tu cuenta como parámetro de consulta, igual que la API de Usage & Quota. Genéralo en el panel, en Account → API Tokens. Cada uno tiene un límite de 30 solicitudes por minuto.

El parámetro de ruta {membership} acepta el Membership ID que se muestra en la página del plan (por ejemplo 68057) o el código corto de la URL del plan (por ejemplo Rxqk).

Listar subcuentas

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts

Devuelve todas las subcuentas vistas en el plan en los últimos 365 días, ordenadas por nombre.

Parámetro	En	Obligatorio	Descripción
membership	ruta	sí	Membership ID o código corto
api_token	consulta	sí	El token de API de tu cuenta

Ejemplo:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts?api_token=YOUR_API_TOKEN"

Respuesta:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccounts": ["BigReseller_7", "client_a", "client_b"]
  }
}

Un plan que nunca ha enviado tráfico de subcuenta devuelve una lista vacía.

Uso de subcuenta en un intervalo de tiempo

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts/{subaccount}/usage

El tráfico que usó una subcuenta entre dos puntos en el tiempo.

Parámetro	En	Obligatorio	Descripción
membership	ruta	sí	Membership ID o código corto
subaccount	ruta	sí	Nombre de la subcuenta, con mayúsculas y minúsculas exactas
api_token	consulta	sí	El token de API de tu cuenta
start	consulta	sí	Inicio del intervalo, inclusive
end	consulta	sí	Final del intervalo, exclusive

start y end aceptan una fecha (2026-10-01) o una marca de tiempo completa (2026-10-01T09:00:00), con una separación máxima de 366 días. Las horas se leen en hora de París, el reloj con el que funcionan los contadores de tráfico.

Ejemplo:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts/client_a/usage?start=2026-10-01&end=2026-11-01&api_token=YOUR_API_TOKEN"

Respuesta:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccount": "client_a",
    "start": "2026-10-01T00:00:00",
    "end": "2026-11-01T00:00:00",
    "granularity": "day",
    "bytes": 412380000000,
    "gb": 412.38,
    "upload_bytes": 18230000000,
    "download_bytes": 394150000000,
    "requests": 9184402
  }
}

Granularidad

El tráfico se contabiliza en intervalos (buckets), y cada bucket que toca la ventana se cuenta por completo:

• Las ventanas que empiezan dentro de los últimos 7 días usan buckets por hora ("granularity": "hour").
• Las ventanas más antiguas usan buckets diarios ("granularity": "day"), por lo que una ventana desde 2026-09-01T15:00:00 cuenta todo el 1 de septiembre.

Para obtener cifras exactas por día, usa días completos como ventanas.

Una subcuenta sin tráfico en la ventana, o una que haya caducado, devuelve ceros.

Errores

Estado	Significado
400	El plan no es un plan de Residential Proxies, el nombre de la subcuenta no es válido, o start/end faltan, están en orden incorrecto, o superan los 366 días de separación
401	Falta el api_token o no es válido
403	El plan está en un workspace al que no perteneces
404	Plan no encontrado
429	Límite de solicitudes alcanzado, reintenta con backoff
503	Los datos de subcuenta no están disponibles temporalmente, reintenta con backoff