API 4pricing para desarrolladores

Esta es la forma más corta de ver tus datos de 4pricing en tu propia web. Copiarás un archivo, pegarás en él tu clave y lo subirás a tu hosting: sin frameworks ni instalaciones.

1. 1

   Paso 1: Crea tu clave de API

   Entra en panel.4pricing.net y abre Monitorización de precios → Claves API.

   Haz clic en “Generar clave”, ponle un nombre (por ejemplo “mi tienda”) y copia la clave que empieza por prc_live_. Solo se muestra una vez: si la pierdes, crea otra y revoca la anterior.

   Abrir Claves API en el panel →

2. 2

   Paso 2: Copia el archivo ya preparado y pega tu clave

   Copia el archivo PHP de abajo en un editor de texto (Bloc de notas, TextEdit o VS Code) y guárdalo como 4pricing-precios.php.

   php4pricing-precios.php
   <?php
   // =====================================================================
   // PEGA AQUÍ TU CLAVE DE API (panel.4pricing.net → Claves API), entre las comillas
   $apiKey = 'PEGA_AQUI_TU_CLAVE';
   // =====================================================================
   
   header('Content-Type: text/html; charset=utf-8');
   
   function h($text) { return htmlspecialchars((string) $text, ENT_QUOTES, 'UTF-8'); }
   function money($cents) {
       if ($cents === null) { return '—'; }
       return number_format($cents / 100, 2, ',', '.');
   }
   
   if (strpos($apiKey, 'prc_') !== 0) {
       exit('<p>' . h('Falta la clave de API: abre el archivo y pega tu clave en la línea marcada.') . '</p>');
   }
   
   $ch = curl_init('https://4pricing.net/api/v1/pricing/groups/');
   curl_setopt_array($ch, [
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_USERAGENT => 'my-shop-integration/1.0',
       CURLOPT_TIMEOUT => 30,
       CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey, 'Accept: application/json'],
   ]);
   $body = curl_exec($ch);
   $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
   
   if ($body === false) {
       exit('<p>' . h('No se pudo conectar con 4pricing:' . ' ' . curl_error($ch)) . '</p>');
   }
   if ($status !== 200) {
       $hints = [401 => 'la clave de API es incorrecta o fue revocada', 402 => 'la cuenta no tiene una suscripción activa a 4pricing (o no tiene créditos suficientes)', 429 => 'demasiadas peticiones en un minuto, inténtalo de nuevo dentro de un minuto'];
       $hint = isset($hints[$status]) ? ' — ' . $hints[$status] : '';
       exit('<p>' . h('4pricing respondió con el error' . ' ' . $status . $hint) . '</p><pre>' . h($body) . '</pre>');
   }
   
   $groups = json_decode($body, true);
   $verdicts = [
       'cheapest' => 'Eres el más barato',
       'too_cheap' => 'Mucho más barato que el mercado: puedes subir el precio',
       'competitive' => 'Competitivo',
       'too_expensive' => 'Más caro que la mayoría de los competidores',
       'no_competitors' => 'Aún no hay precio de la competencia',
       'no_own_price' => 'Falta tu precio',
   ];
   
   echo '<!doctype html><html><head><meta charset="utf-8"><title>' . h('Mis productos monitorizados') . '</title>';
   echo '<style>body{font-family:Arial,sans-serif;margin:24px}table{border-collapse:collapse}';
   echo 'th,td{border:1px solid #ddd;padding:6px 10px;text-align:left}th{background:#f5f5f5}</style>';
   echo '</head><body><h1>' . h('Mis productos monitorizados') . '</h1>';
   
   if (!$groups) {
       echo '<p>' . h('Todavía no tienes productos comparados.') . '</p>';
   } else {
       echo '<table><tr><th>' . h('Producto') . '</th><th>' . h('SKU') . '</th>';
       echo '<th>' . h('Tu precio') . '</th><th>' . h('Competidor más barato') . '</th>';
       echo '<th>' . h('Diferencia') . '</th><th>' . h('Veredicto') . '</th></tr>';
       foreach ($groups as $g) {
           $yours = $g['own_price_cents_effective'];
           $cheapest = $g['min_competitor_cents'];
           $diff = '—';
           if ($yours !== null && $cheapest !== null) {
               $diff = ($yours > $cheapest ? '+' : '') . money($yours - $cheapest);
           }
           $verdict = isset($verdicts[$g['verdict']]) ? $verdicts[$g['verdict']] : $g['verdict'];
           echo '<tr><td>' . h($g['name']) . '</td><td>' . h($g['sku']) . '</td>';
           echo '<td>' . money($yours) . '</td><td>' . money($cheapest) . '</td>';
           echo '<td>' . $diff . '</td><td>' . h($verdict) . '</td></tr>';
       }
       echo '</table>';
   }
   echo '</body></html>';
   

   Copiar

   Sustituye PEGA_AQUI_TU_CLAVE por tu clave, manteniendo las comillas que la rodean. Es la única línea que tienes que cambiar.
3. 3

   Paso 3: Sube el archivo y ábrelo en el navegador

   Sube 4pricing-precios.php a tu web con el Administrador de archivos o por FTP, en la misma carpeta que tu sitio (normalmente public_html).

   Abre https://tu-sitio/4pricing-precios.php en el navegador. Verás una tabla con cada producto comparado: tu precio, el precio más bajo de la competencia, la diferencia y el veredicto.

El archivo: lista tus productos con el precio más bajo de la competencia

El archivo pide a 4pricing tus productos comparados (GET /groups/) y los muestra en una tabla. Leer datos es gratis y no consume créditos.

• “Tu precio” es el precio que 4pricing conoce para ti; “Competidor más barato” es el precio más bajo encontrado entre los competidores que monitorizas.
• Los precios se muestran en unidades (12999 céntimos pasan a ser 129,99); un guion (—) significa que 4pricing aún no tiene precio, no que sea cero.
• Si en lugar de la tabla ves un error, el mensaje te indica qué corregir: clave incorrecta, suscripción no activa o demasiadas peticiones en un minuto.

Segunda receta: enviar tu precio

Úsala cuando 4pricing deba conocer tu propio precio sin leerlo de la página de tu tienda, por ejemplo directamente desde la base de datos de tu tienda. Enviar tus precios es gratis (sin créditos) y no cuenta para el límite de URL monitorizadas de tu plan.

php4pricing-enviar-precio.php
<?php
// =====================================================================
// PEGA AQUÍ TU CLAVE DE API (panel.4pricing.net → Claves API), entre las comillas
$apiKey = 'PEGA_AQUI_TU_CLAVE';
// =====================================================================

// TUS PRODUCTOS: un bloque por producto. price_cents = precio x 100 (49,99 pasa a ser 4999).
$products = [
    [
        'sku' => 'CAMISETA-BLANCA-M',
        'name' => 'Camiseta blanca, talla M',
        'url' => 'https://tu-tienda.example/camiseta-blanca-m',
        'price_cents' => 4999,
        'currency' => 'EUR',
    ],
];

header('Content-Type: text/html; charset=utf-8');

function h($text) { return htmlspecialchars((string) $text, ENT_QUOTES, 'UTF-8'); }

if (strpos($apiKey, 'prc_') !== 0) {
    exit('<p>' . h('Falta la clave de API: abre el archivo y pega tu clave en la línea marcada.') . '</p>');
}

$ch = curl_init('https://4pricing.net/api/v1/pricing/own-products/bulk');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => 'my-shop-integration/1.0',
    CURLOPT_TIMEOUT => 60,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey, 'Content-Type: application/json', 'Accept: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['items' => $products], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($body === false) {
    exit('<p>' . h('No se pudo conectar con 4pricing:' . ' ' . curl_error($ch)) . '</p>');
}
if ($status !== 200) {
    $hints = [401 => 'la clave de API es incorrecta o fue revocada', 402 => 'la cuenta no tiene una suscripción activa a 4pricing (o no tiene créditos suficientes)', 429 => 'demasiadas peticiones en un minuto, inténtalo de nuevo dentro de un minuto'];
    $hint = isset($hints[$status]) ? ' — ' . $hints[$status] : '';
    exit('<p>' . h('4pricing respondió con el error' . ' ' . $status . $hint) . '</p><pre>' . h($body) . '</pre>');
}

$result = json_decode($body, true);
echo '<h1>' . h('Precios enviados a 4pricing') . '</h1>';
echo '<p>' . h('Productos nuevos creados:') . ' ' . (int) $result['created'] . '</p>';
echo '<p>' . h('Productos actualizados:') . ' ' . (int) $result['updated'] . '</p>';
if (!empty($result['errors'])) {
    echo '<p>' . h('Filas con problemas:') . '</p><ul>';
    foreach ($result['errors'] as $error) {
        echo '<li>' . h($error) . '</li>';
    }
    echo '</ul>';
}

• Guárdalo como 4pricing-enviar-precio.php, pega tu clave, edita las filas de productos, súbelo y ábrelo una vez: la página muestra cuántos productos se han creado y cuántos actualizado.
• Cada petición puede llevar hasta 2.000 productos; una fila incorrecta se notifica y las demás se guardan igualmente. Si vuelves a enviar el mismo sku, el precio se actualiza.

Las mismas llamadas con curl

Si prefieres la terminal, estos dos comandos hacen exactamente lo mismo que los dos archivos PHP:

bash
curl https://4pricing.net/api/v1/pricing/groups/ \
  -H "X-API-Key: PEGA_AQUI_TU_CLAVE"

bash
curl -X POST https://4pricing.net/api/v1/pricing/own-products/bulk \
  -H "X-API-Key: PEGA_AQUI_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"sku":"CAMISETA-BLANCA-M","name":"Camiseta blanca, talla M","url":"https://tu-tienda.example/camiseta-blanca-m","price_cents":4999,"currency":"EUR"}]}'

• Cada petición lleva tu clave en la cabecera X-API-Key. Authorization: Bearer prc_live_… también funciona (solo para las claves que empiezan por prc_).
• No hay permisos por ámbito (scopes): una clave puede leer y modificar todo en tu cuenta de 4pricing. Crea una clave por integración (tienda, ERP, informe) para poder revocar una sin detener las demás.
• Una clave ausente, incorrecta o revocada recibe 401. La revocación surte efecto de inmediato. Demasiadas claves no válidas en un minuto reciben 429.
• Las claves se crean, se listan y se revocan solo en el panel (Monitorización de precios → Claves API); la propia API no puede gestionar claves. Crear una clave requiere una suscripción activa a 4pricing.

http
X-API-Key: prc_live_…
# or
Authorization: Bearer prc_live_…

• Cada ruta de esta documentación es relativa a la URL base: /groups/ significa https://4pricing.net/api/v1/pricing/groups/.
• Las peticiones y las respuestas son JSON (Content-Type: application/json).
• Los importes son números enteros en la unidad menor (céntimos): price_cents = 12999 significa 129,99. Los porcentajes van en puntos básicos (100 = 1 %).
• Un valor desconocido es null, nunca 0: muéstralo como “—”.
• Las colecciones se llaman con barra final (/products/, /groups/, /insights/).
• Las listas paginadas devuelven el total en la cabecera X-Total-Count (por ejemplo GET /products/?skip=0&limit=200).
• Envía una cabecera User-Agent que identifique tu integración (por ejemplo my-shop-integration/1.0). El cortafuegos que hay delante de la API responde 403 a algunos valores genéricos por defecto de las librerías, como Python-urllib.

Límite de peticiones

• 60 peticiones por minuto por CUENTA, en una ventana deslizante: todas las claves de la misma cuenta comparten esas mismas 60.
• Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (la duración de la ventana, en segundos).
• Si superas el límite recibes 429 con una cabecera Retry-After (segundos). Espera ese tiempo y vuelve a intentarlo: los ejemplos de más abajo lo hacen por ti.

http
HTTP/2 200
x-ratelimit-limit: 60
x-ratelimit-remaining: 59
x-ratelimit-reset: 60

HTTP/2 429
retry-after: 60
{"detail":"Rate limit exceeded"}

Suscripción y límites del plan

• La API requiere una suscripción activa a 4pricing; sin ella, cada petición recibe 402 con el código plan_required.
• Todos los planes incluyen la API con los mismos límites que el panel. Si superas un límite al añadir o reactivar algo, recibes 402 con el código plan_limit y un mensaje que indica qué límite es.

Leer la página de una tienda consume créditos del monedero de tu cuenta. Las llamadas siguientes comprueban el saldo ANTES de leer nada: si no es suficiente recibes 402 insufficient_credits, y si el monedero no se puede consultar en este momento recibes 503 credit_wallet_unavailable (reintenta más tarde). En ninguno de los dos casos se lee nada ni se cobra nada.

Llamadas que consumen créditos

Llamadas gratuitas

• Cualquier lectura (GET): productos, grupos, comparaciones, histórico, alertas, insights, briefings, créditos, estadísticas.
• POST /own-products/ y POST /own-products/bulk: tus propios precios.
• POST /sales/bulk: tus ventas.
• Alertas, ajustes, confirmaciones y todo lo demás que no lea la página de una tienda.

• La monitorización programada de las URL que sigues también consume créditos, en cada comprobación; GET /credits/ muestra tu saldo y la previsión.
• POST /products/import añade muchas URL de una vez sin leerlas de inmediato: la monitorización programada las comprueba, y las cobra, más adelante.

Todas las operaciones a las que puede acceder una clave, agrupadas según su finalidad. La especificación OpenAPI describe cada una campo por campo, con los cuerpos exactos de petición y respuesta.

Tus propios precios

Dile a 4pricing tu precio directamente, sin leer la página de tu tienda. Gratis.

Productos comparados (grupos)

Un grupo es un producto tuyo junto con las páginas de la competencia que venden lo mismo. Contiene el veredicto y el precio recomendado.

URL monitorizadas

Una fila por cada dirección de página que 4pricing lee, tuya o de un competidor (role own o competitor).

Búsqueda en vivo

Consulta ahora mismo el precio de un producto en las tiendas.

Alertas

Reglas de precio y la bandeja de las alertas que han saltado.

Créditos

Saldo, previsión y cada movimiento de créditos.

Tus ventas

Ventas diarias por producto, usadas para calcular el valor de cada oportunidad. Gratis.

Insights, oportunidades y briefings

Qué ha cambiado, por qué importa y qué hacer, además del briefing diario.

Acciones de precio

Cambios de precio que se han propuesto, enviado, aplicado o revertido. Con la API puedes leerlos y confirmar los recibidos por webhook.

Ajustes

Ajustes de la cuenta, incluida la dirección y el secreto del webhook.

Estadísticas

Resumen de la cuenta y estado de las comprobaciones de precio.

53 endpoints · https://4pricing.net/api/v1/pricing/openapi.json

Algunas cosas se quedan en el panel a propósito, donde decide una persona con sesión iniciada. A través de la API estas rutas responden 404:

4pricing puede enviar eventos a una dirección tuya (un webhook): hace un POST con JSON cada vez que ocurre algo, así tu sistema no tiene que estar preguntando continuamente.

Hay una dirección de webhook por cuenta; todos los tipos de evento van a ella. Distínguelos por el campo event: la alerta es el único evento que no lo lleva.

Cómo activarlo

• Define alert_webhook_url (una dirección http/https pública en el puerto 80 o 443), alert_webhook_secret y alert_webhook_enabled: true, en el panel o con PUT /settings/.
• Una dirección que resuelva a una red privada o interna se rechaza con 422. Las redirecciones no se siguen.
• Para briefing.ready activa también briefing_webhook_enabled. price.apply y price.revert solo se envían para los grupos enlazados con tu tienda con store_kind = webhook, y solo si hay un secreto definido.

bash
curl -X PUT https://4pricing.net/api/v1/pricing/settings/ \
  -H "X-API-Key: PEGA_AQUI_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"alert_webhook_url":"https://your-shop.example/4pricing-webhook.php","alert_webhook_secret":"TU_SECRETO_DE_WEBHOOK","alert_webhook_enabled":true,"briefing_webhook_enabled":true}'

Eventos

Cabeceras de cada petición de webhook

Verificar la firma

Recalcula la firma a partir de la cabecera de marca de tiempo y del cuerpo en bruto (RAW) que recibiste, compárala en tiempo constante y comprueba la marca de tiempo. Solo entonces procesa el evento. Responde con cualquier 2xx cuando lo hayas aceptado.

php
<?php
$secret = 'TU_SECRETO_DE_WEBHOOK';

// Usa el cuerpo en bruto (RAW), exactamente como lo recibes, no un JSON recodificado
$body = file_get_contents('php://input');
$timestamp = isset($_SERVER['HTTP_X_4PRICING_TIMESTAMP']) ? $_SERVER['HTTP_X_4PRICING_TIMESTAMP'] : '';
$signature = isset($_SERVER['HTTP_X_4PRICING_SIGNATURE']) ? $_SERVER['HTTP_X_4PRICING_SIGNATURE'] : '';
$expected = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $body, $secret);

// Firma incorrecta o con más de 5 minutos de antigüedad: rechazar
if (!hash_equals($expected, $signature) || abs(time() - (int) $timestamp) > 300) {
    http_response_code(401);
    exit;
}

$event = json_decode($body, true);
if (isset($event['event']) && ($event['event'] === 'price.apply' || $event['event'] === 'price.revert')) {
    // Aplica new_price_cents al producto de tu tienda (identifícalo por sku o store_product_id)
    // $event['group']['sku'], $event['new_price_cents'], $event['currency']
    // Después confirma: POST /actions/{action_id}/confirm con tu clave de API
}
http_response_code(200);
echo 'ok';

javascript
// Node.js, no package needed
const http = require("http");
const crypto = require("crypto");
const SECRET = process.env.WEBHOOK_SECRET; // TU_SECRETO_DE_WEBHOOK

http.createServer((req, res) => {
  const chunks = [];
  req.on("data", (c) => chunks.push(c));
  req.on("end", () => {
    // Usa el cuerpo en bruto (RAW), exactamente como lo recibes, no un JSON recodificado
    const body = Buffer.concat(chunks);
    const ts = String(req.headers["x-4pricing-timestamp"] || "");
    const sig = String(req.headers["x-4pricing-signature"] || "");
    const expected = "sha256=" + crypto.createHmac("sha256", SECRET).update(ts + ".").update(body).digest("hex");
    const fresh = Math.abs(Date.now() / 1000 - Number(ts)) <= 300;
    const same = sig.length === expected.length && crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
    if (!same || !fresh) {
      // Firma incorrecta o con más de 5 minutos de antigüedad: rechazar
      res.writeHead(401);
      return res.end();
    }
    const event = JSON.parse(body.toString("utf8"));
    if (event.event === "price.apply" || event.event === "price.revert") {
      // Aplica new_price_cents al producto de tu tienda (identifícalo por sku o store_product_id)
      // Después confirma: POST /actions/{action_id}/confirm con tu clave de API
    }
    res.writeHead(200);
    res.end("ok");
  });
}).listen(3000);

python
# Python 3, standard library only
import hashlib
import hmac
import time

SECRET = "TU_SECRETO_DE_WEBHOOK"


def is_valid(raw_body: bytes, timestamp: str, signature: str) -> bool:
    # Usa el cuerpo en bruto (RAW), exactamente como lo recibes, no un JSON recodificado
    if not timestamp.isdigit() or abs(time.time() - int(timestamp)) > 300:
        return False
    expected = "sha256=" + hmac.new(
        SECRET.encode(), timestamp.encode() + b"." + raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

Entrega y reintentos

• Alertas: ante un error de conexión o de DNS, 429 o 5xx, la petición se reintenta con espera exponencial, con un máximo de 5 intentos. Cualquier otro 4xx es definitivo.
• Si la petición salió pero no llegó respuesta en 10 segundos, no se vuelve a enviar (para evitar un duplicado); aun así, en raras ocasiones puedes recibir un duplicado, por eso desduplica por event_id.
• price.apply y price.revert se envían una sola vez: si la entrega falla, la acción pasa a failed. Desduplica por action_id.
• briefing.ready se envía una vez al día.

Confirmar un precio que has aplicado

• Un price.apply no se considera aplicado hasta que tu sistema lo indique. Después de cambiar el precio en tu tienda, llama a POST /actions/{action_id}/confirm con tu clave de API: la acción pasa de “enviada” a “aplicada”.
• Confirmar dos veces no hace daño: una acción que ya está aplicada se devuelve tal cual.

bash
curl -X POST https://4pricing.net/api/v1/pricing/actions/ACTION_ID/confirm \
  -H "X-API-Key: PEGA_AQUI_TU_CLAVE"

Cuerpos de ejemplo

json · price.apply
{
  "event": "price.apply",
  "action_id": "8d0f2c4e-0b7a-4f7e-9d61-3c2b1a0e9f55",
  "tenant_id": "…",
  "group": {
    "id": "2fa912df-440c-4ddf-896a-5d558d56085f",
    "name": "Canon RF 50mm F1.8 STM",
    "sku": "4515C005AA",
    "ean": "4549292181623",
    "store_product_id": "1042"
  },
  "old_price_cents": 124900,
  "new_price_cents": 118699,
  "currency": "RON",
  "reason_code": "undercut",
  "mode": "manual",
  "confirm": { "method": "POST", "path": "/api/v1/pricing/actions/8d0f2c4e-0b7a-4f7e-9d61-3c2b1a0e9f55/confirm" }
}

json · alert
{
  "event_id": 18342,
  "alert_id": "c1b5…",
  "alert_type": "competitor_undercut",
  "tenant_id": "…",
  "message_code": "competitor_undercut",
  "message": "…",
  "message_params": { "…": "…" },
  "price_cents": 118990,
  "currency": "RON",
  "triggered_at": "2026-10-13T07:05:12",
  "product": { "id": "…", "name": "…", "url": "https://…", "retailer": "…", "current_price_cents": 118990, "in_stock": true },
  "group": { "id": "…", "name": "Canon RF 50mm F1.8 STM", "sku": "4515C005AA" },
  "panel_url": "https://panel.4pricing.net/…"
}

Los errores llegan con el estado HTTP adecuado y un cuerpo JSON {"detail": …}. detail es un texto, un objeto con un código que puedes tratar en tu programa o, en el caso de 422, la lista de campos no válidos.

Cuerpos de error

json
{"detail": "Invalid or missing API key"}
{"detail": {"code": "plan_required", "message": "…"}}
{"detail": {"code": "insufficient_credits", "message": "…"}}
{"detail": [{"loc": ["body", "price_cents"], "msg": "…", "type": "…"}]}

La misma lectura en cuatro lenguajes, con pausa y reintento ante 429, y después el envío de ventas. Sustituye PEGA_AQUI_TU_CLAVE por tu clave (o define la variable de entorno PRICING_API_KEY).

Node.js: lee tus productos comparados

javascript
// Node.js 18+ (fetch is built in, no package needed)
const API_KEY = process.env.PRICING_API_KEY; // PEGA_AQUI_TU_CLAVE
const BASE = "https://4pricing.net/api/v1/pricing";

async function call(path, options = {}) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const res = await fetch(BASE + path, {
      ...options,
      headers: { "X-API-Key": API_KEY, "Content-Type": "application/json", ...(options.headers || {}) },
    });
    if (res.status === 429) {
      // Más de 60 peticiones/minuto: espera los segundos indicados en Retry-After y vuelve a intentarlo
      const wait = Number(res.headers.get("Retry-After") || 60);
      await new Promise((r) => setTimeout(r, wait * 1000));
      continue;
    }
    if (!res.ok) throw new Error(res.status + " " + (await res.text()));
    return res.status === 204 ? null : res.json();
  }
  throw new Error("rate limited");
}

async function main() {
  // Tus productos comparados: tu precio, el competidor más barato, el veredicto
  const groups = await call("/groups/");
  for (const g of groups) {
    console.log(g.name, g.own_price_cents_effective, g.min_competitor_cents, g.verdict);
  }
}

main().catch((err) => {
  console.error(err.message);
  process.exit(1);
});

Python: lee tus productos comparados

python
# Python 3, standard library only
import json
import os
import time
import urllib.error
import urllib.request

API_KEY = os.environ["PRICING_API_KEY"]  # PEGA_AQUI_TU_CLAVE
BASE = "https://4pricing.net/api/v1/pricing"


def call(path, method="GET", payload=None):
    data = json.dumps(payload).encode() if payload is not None else None
    for _ in range(3):
        req = urllib.request.Request(BASE + path, data=data, method=method, headers={
            "X-API-Key": API_KEY, "Content-Type": "application/json", "Accept": "application/json",
            # Define tu propio User-Agent: el que traen por defecto algunas librerías HTTP (Python urllib) se bloquea con 403
            "User-Agent": "my-shop-integration/1.0",
        })
        try:
            with urllib.request.urlopen(req, timeout=30) as res:
                body = res.read()
                return json.loads(body) if body else None
        except urllib.error.HTTPError as err:
            if err.code == 429:
                # Más de 60 peticiones/minuto: espera los segundos indicados en Retry-After y vuelve a intentarlo
                time.sleep(int(err.headers.get("Retry-After", "60")))
                continue
            raise
    raise RuntimeError("rate limited")


# Tus productos comparados: tu precio, el competidor más barato, el veredicto
for g in call("/groups/"):
    print(g["name"], g["own_price_cents_effective"], g["min_competitor_cents"], g["verdict"])

curl: envía tus ventas diarias

bash
curl -X POST https://4pricing.net/api/v1/pricing/sales/bulk \
  -H "X-API-Key: PEGA_AQUI_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"sku":"CAMISETA-BLANCA-M","day":"2026-10-12","units_sold":7,"revenue_cents":34993}]}'

PHP: envía tus ventas diarias

php
<?php
$apiKey = 'PEGA_AQUI_TU_CLAVE';

// Ventas diarias por producto (por sku o group_id), hasta 2.000 filas por petición
$rows = [
    ['sku' => 'CAMISETA-BLANCA-M', 'day' => '2026-10-12', 'units_sold' => 7, 'revenue_cents' => 34993],
];

$ch = curl_init('https://4pricing.net/api/v1/pricing/sales/bulk');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => 'my-shop-integration/1.0',
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['rows' => $rows]),
]);
$body = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . ' ' . $body;   // 200 {"upserted": 1, "skipped": []}