API: Catálogo de productos · Docs Kids Solutions

El endpoint /api/shop/products entrega el catálogo público de Kids Solutions con filtros estructurados. Pensado para agregadores, builders, scripts de research o herramientas internas de marcas partner.

Endpoint

GET https://kids.circles-ai.ai/api/shop/products

Parámetros (query)

category — top, bottom, dress, outerwear, shoes, accessory, sleepwear.
gender — boy, girl, unisex.
season — primavera, verano, otono, invierno, todos.
brand — slug exacto de la marca.
minPrice / maxPrice — números enteros en USD.
onlyDiscount, onlyNew, onlyLimited, onlyExclusive — booleans.
sort — newest, price_asc, price_desc, discount, rating.
limit — máximo 48 por request.

Ejemplo cURL

curl -G "https://kids.circles-ai.ai/api/shop/products" \
  --data-urlencode "category=top" \
  --data-urlencode "gender=girl" \
  --data-urlencode "sort=discount" \
  --data-urlencode "limit=12"

Respuesta

{
  "products": [
    {
      "id": "uuid",
      "name": "Camiseta orgánica",
      "brand": "Mini Boden",
      "price_current": 22.50,
      "price_original": 30.00,
      "discount_pct": 25,
      "currency": "USD",
      "image_url": "https://...",
      "affiliate_url": "https://...",
      "is_new": false,
      "is_limited": false,
      "rating": 4.8
    }
  ]
}

Cada affiliate_url ya incluye los parámetros UTM y el tag de afiliado de Kids Solutions. Reutilizarlo en tus propios sitios no es permitido por términos.

Buenas prácticas

Pagina con limit + offset en lotes ≤ 48.
Cachea por categoría/género durante 5–10 minutos.
Si te interesan stocks/precios en tiempo real → contacta a partners@circles.ai.