Entrar

Buscar productos por nombre

GET https://{organization}.myguper.com/api/order/product/search

Reemplazado por GET /api/register/event/search (register). El audience builder ahora coincide el nombre del producto directamente vía el filtro genérico event (type=buy_product) — sin el paso nombre→SKU. Este endpoint sigue funcionando, pero el camino boughtSku / person_order_item es legado (se elimina en el cutover).

Resuelve términos de texto libre del nombre del producto en el conjunto de SKUs (skuRefId) que se vendieron con nombres que coinciden. Impulsa el audience builder: los SKUs devueltos alimentan el filtro de audiencia boughtSku en el register.

terms es texto libre — los términos separados por espacio se combinan con AND (acepta string terms=a b o repetido terms[]=a&terms[]=b). sandalia salto devuelve solo SKUs cuyo nombre contiene ambas palabras (en la misma cadena). La coincidencia ignora mayúsculas y acentos (collation utf8mb4_general_ci), así que tenis coincide con TÊNIS.

El nombre proviene de order_item.productName (un snapshot por línea — Guper no tiene un catálogo de productos separado). El resultado se agrupa por skuRefId; cada elemento trae un name representativo y el conteo de líneas que coinciden (hits), ordenado por hits desc. Sin alcance de interface — skuRefId es la referencia canónica de SKU de la organización.

Auth: signature RSA servicio-a-servicio (ver Internal › Integração › Signature). La organización se toma del contexto de la solicitud.

Ejemplo práctico

1. Buscar — encontrar los SKUs llamados "sandalia salto":

GET /api/order/product/search?terms=sandalia%20salto
{
    "terms": ["sandalia", "salto"],
    "total": 1,
    "products": [
        { "sku": "47142", "name": "Sandalia Salto Alto 38", "hits": 14 }
    ]
}

2. Armar la audiencia — usar los sku devueltos en el filtro boughtSku de la query de audiencia del register (aquí: compró en los últimos 3 meses):

[
    ["boughtSku", "in", { "list": ["47142"] }, { "int": 3 }]
]

Combina con otros filtros via AND — ej.: hombres que compraron: antepón ["gender","equals",{"string":"male"}], "AND",. Referencia completa de boughtSku en Internal › Services › Register › Audiência por produto.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Parámetros de query

Name Type Description
terms * string Términos de texto libre. Los términos separados por espacio se combinan con AND en el nombre del producto. También acepta array (`terms[]=sandalia&terms[]=salto`). `terms` vacío devuelve un resultado vacío.
limit integer Máximo de SKUs devueltos (1..2000, default 500). Términos amplios pueden alcanzar el tope — refina (un resultado grande también genera un `boughtSku IN (...)` grande).

Respuestas

{
    "terms": ["sandalia", "salto"],
    "total": 1,
    "products": [
        { "sku": "47142", "name": "Sandalia Salto Alto 38", "hits": 14 }
    ]
}
Copied to clipboard