Tu asistente de IA ya puede llevar una tienda de verdad

De borrador a producto en vivo en cinco pasos

Todo lo que sigue es curl sin más: no necesitas SDK. Copia, pega y vende.

1. 1

   Crea un producto en borrador

   Los precios son enteros en centavos (priceCents). El producto empieza como borrador: todavía no es público.

   bash

   Copiar

   curl -X POST https://www.getly.store/api/v1/products \
     -H "Authorization: Bearer $GETLY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Notion Icon Pack",
       "priceCents": 900,
       "description": "500 hand-drawn icons for Notion dashboards."
     }'

   Respuesta · 201 · application/json

   {
     "success": true,
     "data": {
       "id": "6b4e6a52-9d2e-4c8a-b1f3-2a9c0d5e7f10",
       "name": "Notion Icon Pack",
       "slug": "notion-icon-pack-m9x2kz",
       "status": "draft",
       "priceCents": 900,
       "urls": {
         "product": "https://www.getly.store/product/notion-icon-pack-m9x2kz",
         "buy": "https://www.getly.store/product/notion-icon-pack-m9x2kz"
       }
     }
   }

2. 2

   Obtén una URL de subida

   La API devuelve una URL prefirmada para archivos de hasta 2 GB. Tus bytes van directos al almacenamiento, no pasan por nuestros servidores.

   bash

   Copiar

   curl -X POST https://www.getly.store/api/v1/products/$PRODUCT_ID/files/presign \
     -H "Authorization: Bearer $GETLY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{ "fileName": "icons.zip", "fileSize": 1048576, "fileType": "application/zip" }'

   Respuesta · 200 · application/json

   {
     "success": true,
     "data": {
       "uploadUrl": "https://<account>.r2.cloudflarestorage.com/...&X-Amz-Signature=...",
       "fileUrl": "https://pub-xxxxxxxx.r2.dev/files/.../aB3xYz.zip",
       "fileName": "icons.zip",
       "fileSize": 1048576
     }
   }

3. 3

   Sube el archivo y adjúntalo

   Haz PUT de los bytes sin procesar a la URL de subida y luego adjunta al producto el fileUrl que te devuelven.

   bash

   Copiar

   curl -X PUT "$UPLOAD_URL" \
     -H "Content-Type: application/zip" \
     --data-binary @icons.zip
   
   curl -X POST https://www.getly.store/api/v1/products/$PRODUCT_ID/files \
     -H "Authorization: Bearer $GETLY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{ "fileUrl": "<fileUrl from step 2>", "fileName": "icons.zip",
           "fileSize": 1048576, "fileType": "application/zip" }'

   Respuesta · 201 · application/json

   {
     "success": true,
     "data": {
       "id": "0f8c31d7-4e2a-49b6-9c1d-8e5a7b3f2c40",
       "fileName": "icons.zip",
       "fileSize": 1048576,
       "isLatest": true
     }
   }

4. 4

   Publica

   Una sola llamada envía el producto a revisión; sale a la venta cuando se aprueba, normalmente en pocas horas. Si falta algo, recibes motivos legibles por máquina en lugar de un error vago.

   bash

   Copiar

   curl -X POST https://www.getly.store/api/v1/products/$PRODUCT_ID/publish \
     -H "Authorization: Bearer $GETLY_API_KEY"

   Respuesta · 200 · application/json

   {
     "success": true,
     "data": {
       "id": "6b4e6a52-9d2e-4c8a-b1f3-2a9c0d5e7f10",
       "status": "active",
       "priceCents": 900,
       "urls": {
         "product": "https://www.getly.store/product/notion-icon-pack-m9x2kz",
         "buy": "https://www.getly.store/product/notion-icon-pack-m9x2kz"
       }
     }
   }

5. 5

   Aprobado y a la venta

   Los compradores pagan con USDT/USDC, con pago como invitado y sin necesidad de cuenta. Los archivos se entregan automáticamente.

   bash

   Copiar

   open https://www.getly.store/product/notion-icon-pack-m9x2kz

Nota de honestidad: todo producto nuevo pasa por una revisión (estado pending_review) antes de aparecer en público, normalmente en pocas horas. Esto incluye los productos creados por la API, sea cual sea tu historial de ventas.

Conéctalo a tu asistente de IA

El servidor MCP oficial (@getly/mcp) da a Claude, Cursor y cualquier cliente MCP 16 herramientas: crear y publicar productos, subir archivos, escribir publicaciones, crear cupones y enlaces de pago, consultar ventas. Con un bloque de configuración, tu asistente ya es un tendero.

claude mcp add getly --env GETLY_API_KEY=$GETLY_API_KEY -- npx -y @getly/mcp

{
  "mcpServers": {
    "getly": {
      "command": "npx",
      "args": ["-y", "@getly/mcp"],
      "env": { "GETLY_API_KEY": "getly_sk_live_..." }
    }
  }
}

{
  "mcpServers": {
    "getly": {
      "command": "npx",
      "args": ["-y", "@getly/mcp"],
      "env": { "GETLY_API_KEY": "getly_sk_live_..." }
    }
  }
}

El servidor lee tu clave solo de la variable de entorno GETLY_API_KEY. No pegues nunca claves en prompts, código ni commits.

Una comisión honesta. Todo incluido.

Las ventas que generas con la API o el widget son tu propio tráfico: Getly se queda el 10% y esa es toda la factura. Las ventas que llegan del marketplace empiezan en el 20% y bajan al 12% con el volumen. El modelo completo está en getly.store/pricing, y mira lo que compra realmente esa única comisión.

Los vendedores nuevos se quedan con el 90% durante sus primeros 90 días.

Pensado para cómo se vende software en 2026

Toda la tienda, en endpoints

Todas las funciones de abajo incluyen paginación por cursor, claves de idempotencia, cabeceras de límite de uso y errores legibles por LLM.

Caso de éxito

BotLaunch gestiona su marketplace de plantillas con esta API

BotLaunch, una plataforma sin código para bots de Telegram y tiendas de Mini Apps, conecta las cuentas de sus autores con Getly y publica sus plantillas como productos activos de Getly, todo con la misma API que acabas de ver en esta página.

Especificaciones y referencias