Developers

Documentación para desarrolladores

Todo lo que necesitas para integrar Kids Solutions desde tu producto, marca o agencia. API REST, webhooks, schema markup y guías paso a paso para partners.

Empezar

Kids Solutions es una plataforma AI-first en español para padres latinoamericanos. El stack productivo es:

Frontend: Next.js 16 App Router + TypeScript + Tailwind v4 + shadcn/ui + Framer Motion v12.
Backend: Next.js API routes + Anthropic SDK (agentic loop con tool use). Modelos: claude-sonnet-4-6, claude-opus-4-7, claude-haiku-4-5.
Data: Supabase (Postgres + pgvector + Auth + Storage). Rate limiting vía Upstash.
Hosting: Vercel · dominio kids.circles-ai.ai.

Todos los endpoints públicos responden JSON. Los endpoints privados requieren cookie de sesión Supabase. Las llamadas IA están protegidas por TokenBudgetManager y CircuitBreaker en el orchestrator.

API Reference

Búsqueda Universal

GET /api/search — buscador unificado de productos, marcas, blog.

Catálogo de productos

GET /api/shop/products — filtros, paginación, sort.

Webhooks (roadmap)

Eventos que podrás suscribir desde tu backend.

Onboarding de afiliados

Cómo registrar una marca y conectar tu programa.

Integraciones activas

Mercado Libre

Catálogo multi-país LATAM

eBay

Tiendas oficiales US/UK

AliExpress

Volumen y precio

Amazon

Búsqueda de SKUs premium

Stripe

Suscripciones y billing

Resend

Transactional email

Twilio

WhatsApp alerts

Replicate

Virtual try-on

Open-Meteo

Clima para outfit del día

Schema Markup

Inyectamos JSON-LD según schema.org en las páginas indexables:

Organization · global en layout
SoftwareApplication · global en layout
BlogPosting · cada artículo de /blog
Product · top productos en /shop
FAQPage · /ayuda
BreadcrumbList · todas las páginas internas

Webhook Events (roadmap)

Próximamente publicaremos webhooks para que tus sistemas reaccionen a eventos relevantes:

· partner.application.created
· partner.agreement.signed
· product.click
· wishlist.product_added
· subscription.created / subscription.cancelled

¿Necesitas un evento ya? Escribe a dev@circles.ai.

OpenAPI

Estamos publicando un spec OpenAPI 3 completo en /api/openapi.json durante 2026 Q3. Mientras tanto, los endpoints documentados arriba son estables y versionados implícitamente con el dominio.

Contacto técnico

Si necesitas algo que aún no está documentado o quieres acceso temprano a webhooks, escríbenos. Respondemos en menos de 48 horas hábiles.

dev@circles.ai