El endpoint /api/search es la entrada unificada al universo Kids Solutions: productos, marcas, artículos del blog. Es público, cacheable y devuelve JSON.
Endpoint
GET https://kids.circles-ai.ai/api/search?q=<query>&limit=<n>Parámetros
q— texto libre (obligatorio, mínimo 2 caracteres).limit— número de resultados por categoría (1–20, default 5).
Ejemplo cURL
curl -G "https://kids.circles-ai.ai/api/search" \
--data-urlencode "q=zapatos niño" \
--data-urlencode "limit=5"Respuesta
{
"products": [
{ "id": "...", "name": "...", "price_current": 19.99, "image_url": "..." }
],
"brands": [
{ "id": "...", "name": "Mini Boden", "slug": "mini-boden" }
],
"posts": [
{ "slug": "...", "title": "...", "excerpt": "..." }
]
}Notas
- El endpoint tiene rate limit de 30 req/min por IP.
- Las imágenes pueden requerir referer válido — usa proxy si es necesario.
- Para tracking de clicks, envía los usuarios a
/api/shop/click.
Errores comunes
400 { "error": "q must be at least 2 chars" }
429 { "error": "rate_limited" }
500 { "error": "internal_error" }