API - Documentation

📋 Endpoint: List Services

URL:


                    GET https://comprar-seguidores.me/api/servicios/

Required parameters:

Parameter	Type	Description
`api_key`	string	Your API key

Request examples:

curl "https://comprar-seguidores.me/api/servicios/?api_key=TU_CLAVE"

<?php
$url = 'https://comprar-seguidores.me/api/servicios/';
$params = [
    'api_key' => 'TU_CLAVE'
];

$ch = curl_init($url . '?' . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response);
curl_close($ch);

print_r($result);

import requests

url = 'https://comprar-seguidores.me/api/servicios/'
params = {
    'api_key': 'TU_CLAVE'
}

response = requests.get(url, params=params)
result = response.json()
print(result)

const apiKey = 'TU_CLAVE';
const url = `https://comprar-seguidores.me/api/servicios/?api_key=${apiKey}`;

fetch(url)
.then(response => response.json())
.then(result => console.log(result));

✅ Success (HTTP 200):

{
  "success": true,
  "total": 25,
  "servicios": [
    {
      "servicio_id": 1,
      "nombre": "Seguidores Telegram",
      "red_social": "instagram",
      "tipo": "seguidores",
      "precio_por_1000": 5.00,
      "cantidad_minima": 100,
      "cantidad_maxima": 50000
    }
  ]
}

💡 Tip: Use the servicio_id from this response as a parameter in the Create Order endpoint.

📌 Endpoint: Create Order

URL:


                    POST https://comprar-seguidores.me/api/crear-pedido/

Content-Type:


                    application/json

Required parameters:

Parameter	Type	Description
`api_key`	string	Your API key
`servicio_id`	integer	Service ID
`enlace`	string	Profile/post URL
`cantidad`	integer	Number of units

Evitar pedidos duplicados (recomendado)

Si se corta la conexión no puedes saber si el pedido llegó a crearse, y reintentar crearía uno de más. Envía una clave única por pedido en la cabecera Idempotency-Key (o en el campo idempotency_key del cuerpo, si no puedes poner cabeceras): reintentar con la misma clave devuelve la respuesta del pedido original en lugar de crear otro.

Respuesta	Qué significa
`201` + `Idempotent-Replay: true`	Ya se había creado: es la respuesta original, no un pedido nuevo.
`409`	Hay otra petición con esa misma clave procesándose ahora. Reintenta en unos segundos.
`422`	Esa clave ya se usó con otros parámetros. Usa una clave distinta para cada pedido distinto.

Si el pedido no llega a crearse (por ejemplo, saldo insuficiente), la clave queda libre y puedes reintentar con la misma. Las claves se conservan 24 horas.

Límite de frecuencia

Hasta 20 peticiones cada 10 minutos por cuenta (no por clave: emitir más claves no amplía el límite). Puedes gastarlas de golpe. Al superarlo se responde 429 con la cabecera Retry-After, que indica los segundos que faltan para poder volver a pedir. Los pedidos que hagas desde la web no consumen este límite.

💻 Request Example

curl -X POST https://comprar-seguidores.me/api/crear-pedido/ \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-0001" \
  -d '{
    "api_key": "TU_CLAVE",
    "servicio_id": 1,
    "enlace": "https://instagram.com/usuario",
    "cantidad": 1000
  }'

<?php
$url = 'https://comprar-seguidores.me/api/crear-pedido/';
$data = [
    'api_key' => 'TU_CLAVE',
    'servicio_id' => 1,
    'enlace' => 'https://instagram.com/usuario',
    'cantidad' => 1000
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$result = json_decode($response);
curl_close($ch);

print_r($result);

import requests

url = 'https://comprar-seguidores.me/api/crear-pedido/'
data = {
    'api_key': 'TU_CLAVE',
    'servicio_id': 1,
    'enlace': 'https://instagram.com/usuario',
    'cantidad': 1000
}

response = requests.post(url, json=data)
result = response.json()
print(result)

const url = 'https://comprar-seguidores.me/api/crear-pedido/';
const data = {
    api_key: 'TU_CLAVE',
    servicio_id: 1,
    enlace: 'https://instagram.com/usuario',
    cantidad: 1000
};

fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result));

📨 Responses

✅ Success (HTTP 201):

{
  "success": true,
  "pedido_id": 12345,
  "servicio": "Seguidores Telegram",
  "cantidad": 1000,
  "url": "https://instagram.com/usuario/",
  "precio": 5.00,
  "saldo_anterior": 50.00,
  "saldo_restante": 45.00,
  "estado": "pendiente",
  "mensaje": "Pedido #12345 creado exitosamente"
}

❌ Error (HTTP 400/401/404):

{
  "success": false,
  "error": "Descripción del error"
}

🔍 Endpoint: Check Order Status

URL:


                    GET https://comprar-seguidores.me/api/pedido/estado/

Required parameters:

Parameter	Type	Description
`api_key`	string	Your API key
`pedido_id`	integer	ID of the order to check

Request examples:

curl "https://comprar-seguidores.me/api/pedido/estado/?api_key=TU_CLAVE&pedido_id=12345"

<?php
$url = 'https://comprar-seguidores.me/api/pedido/estado/';
$params = [
    'api_key' => 'TU_CLAVE',
    'pedido_id' => 12345
];

$ch = curl_init($url . '?' . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response);
curl_close($ch);

print_r($result);

import requests

url = 'https://comprar-seguidores.me/api/pedido/estado/'
params = {
    'api_key': 'TU_CLAVE',
    'pedido_id': 12345
}

response = requests.get(url, params=params)
result = response.json()
print(result)

const apiKey = 'TU_CLAVE';
const pedidoId = 12345;
const url = `https://comprar-seguidores.me/api/pedido/estado/?api_key=${apiKey}&pedido_id=${pedidoId}`;

fetch(url)
.then(response => response.json())
.then(result => console.log(result));

✅ Success (HTTP 200):

{
  "success": true,
  "pedido": {
    "pedido_id": 12345,
    "servicio_id": 1,
    "servicio": "Seguidores Telegram",
    "red_social": "instagram",
    "tipo": "seguidores",
    "url": "https://instagram.com/usuario",
    "cantidad": 1000,
    "cantidad_entregada": 1000,
    "precio": 5.00,
    "estado": "completado",
    "creado": "2026-03-04 10:30:00",
    "actualizado": "2026-03-04 11:15:00"
  }
}

💡 Tip: Possible statuses are: pendiente (pending), en_proceso (processing), activo (active), completado (completed), cancelado (canceled), reembolsado (refunded). Use cantidad_entregada to check partial deliveries.

🧾 Endpoint: Order History

URL:


                    GET https://comprar-seguidores.me/api/pedidos/historial/

Required parameters:

Parameter	Type	Description
`api_key`	string	Your API key
`pagina`	integer	Page number, starting at 1 (optional, default 1)
`limite`	integer	Orders per page (optional, default 20, maximum 100)

Request examples:

curl "https://comprar-seguidores.me/api/pedidos/historial/?api_key=TU_CLAVE&pagina=1&limite=20"

<?php
$url = 'https://comprar-seguidores.me/api/pedidos/historial/';
$params = [
    'api_key' => 'TU_CLAVE',
    'pagina' => 1,
    'limite' => 20
];

$ch = curl_init($url . '?' . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response);
curl_close($ch);

print_r($result);

import requests

url = 'https://comprar-seguidores.me/api/pedidos/historial/'
params = {
    'api_key': 'TU_CLAVE',
    'pagina': 1,
    'limite': 20
}

response = requests.get(url, params=params)
result = response.json()
print(result)

const apiKey = 'TU_CLAVE';
const url = `https://comprar-seguidores.me/api/pedidos/historial/?api_key=${apiKey}&pagina=1&limite=20`;

fetch(url)
.then(response => response.json())
.then(result => console.log(result));

✅ Success (HTTP 200):

{
  "success": true,
  "paginacion": {
    "pagina": 1,
    "limite": 20,
    "total": 42,
    "total_paginas": 3
  },
  "pedidos": [
    {
      "pedido_id": 12345,
      "servicio_id": 1,
      "servicio": "Seguidores Telegram",
      "red_social": "instagram",
      "tipo": "seguidores",
      "url": "https://instagram.com/usuario",
      "cantidad": 1000,
      "cantidad_entregada": 1000,
      "precio": 5.00,
      "estado": "completado",
      "creado": "2026-03-04 10:30:00",
      "actualizado": "2026-03-04 11:15:00"
    }
  ]
}

💡 Tip: Use paginacion.total_paginas to page through all results by incrementing pagina. The maximum page size is 100; a larger value is capped.

📊 HTTP Status Codes

Code	Description
`200`	Service list retrieved successfully
`201`	Order created successfully
`400`	Error in submitted parameters
`401`	Invalid or missing API key
`404`	Service not found
`405`	Method not allowed (POST only)
`500`	Internal server error

📡 API - Documentation

📋 Endpoint: List Services

📌 Endpoint: Create Order

💻 Request Example

📨 Responses

🔍 Endpoint: Check Order Status

🧾 Endpoint: Order History

📊 HTTP Status Codes