API - Documentación

📋 Endpoint: Listar Servicios

URL:


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

Parámetros requeridos:

Parámetro	Tipo	Descripción
`api_key`	string	Tu clave API

Ejemplos de petición:

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));

✅ Éxito (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: Usa el servicio_id de esta respuesta como parámetro en el endpoint de Crear Pedido.

📌 Endpoint: Crear Pedido

URL:


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

Content-Type:


                    application/json

Parámetros requeridos:

Parámetro	Tipo	Descripción
`api_key`	string	Tu clave API
`servicio_id`	integer	ID del servicio
`enlace`	string	URL del perfil/publicación
`cantidad`	integer	Cantidad de unidades

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.

💻 Ejemplo de Petición

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));

📨 Respuestas

✅ Éxito (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: Consultar Estado de Pedido

URL:


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

Parámetros requeridos:

Parámetro	Tipo	Descripción
`api_key`	string	Tu clave API
`pedido_id`	integer	ID del pedido a consultar

Ejemplos de petición:

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));

✅ Éxito (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: Los estados posibles son: pendiente, en_proceso, activo, completado, cancelado, reembolsado. Usa cantidad_entregada para verificar entregas parciales.

🧾 Endpoint: Historial de Pedidos

URL:


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

Parámetros requeridos:

Parámetro	Tipo	Descripción
`api_key`	string	Tu clave API
`pagina`	integer	Número de página, desde 1 (opcional, por defecto 1)
`limite`	integer	Pedidos por página (opcional, por defecto 20, máximo 100)

Ejemplos de petición:

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));

✅ Éxito (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: Usa paginacion.total_paginas para recorrer todas las páginas aumentando pagina. El máximo por página es 100; un valor mayor se recorta.

📊 Códigos de Estado HTTP

Código	Descripción
`200`	Lista de servicios obtenida exitosamente
`201`	Pedido creado exitosamente
`400`	Error en los parámetros enviados
`401`	API key inválida o faltante
`404`	Servicio no encontrado
`405`	Método no permitido (solo POST)
`500`	Error interno del servidor

📡 API - Documentación

📋 Endpoint: Listar Servicios

📌 Endpoint: Crear Pedido

💻 Ejemplo de Petición

📨 Respuestas

🔍 Endpoint: Consultar Estado de Pedido

🧾 Endpoint: Historial de Pedidos

📊 Códigos de Estado HTTP