---
title: "List marketplace recommendations"
method: GET
path: "/ordering/customers/{externalCustomerId}/marketplace/recommendations"
tags: ["Ordering API"]
---

# List marketplace recommendations

`GET /ordering/customers/{externalCustomerId}/marketplace/recommendations`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/ordering/customers/{externalCustomerId}/marketplace/recommendations`
- Auth: HTTP bearer

Lista restaurantes recomendados usando la dirección seleccionada del customer.

## Path parameters

- `externalCustomerId` string, required

## Query parameters

- `type` string

## Response `200`

List marketplace recommendations

- object
  - `success` boolean, required
  - `data` OrderingMarketplaceCard[], required: Restaurantes recomendados.
    - `_id` string: ID interno de la card.
    - `storeId` string: ID del local recomendado.
    - `websiteId` string: ID del website recomendado.
    - `baseURL` string: URL base del website.
    - `websiteName` string: Nombre comercial del website.
    - `websiteMarketplaceStagingMode` boolean: Indica si el website está en modo staging.
    - `description` string, nullable: Descripción del comercio.
    - `foodCategoriesTags` string[]: Tags de categorías gastronómicas.
    - `foodCategoriesCodes` string[]: Códigos de categorías gastronómicas.
    - `searchWords` string[]: Palabras de búsqueda indexadas.
    - `averageReview` number: Promedio de reviews.
    - `reviewsCount` string: Cantidad de reviews como texto público.
    - `hasManagedDelivery` boolean: Indica si tiene despacho gestionado.
    - `logo` OrderingImage: Imagen publicada por Justo o por el comercio.
      - `_id` string: ID de la imagen.
      - `url` string: URL original de la imagen.
      - `colorsData` object: Colores calculados de la imagen.
        - `blurhash` string: Blurhash de la imagen.
        - `background` string: Color de fondo sugerido.
        - `front` string: Color frontal sugerido.
      - `dimensions` object: Dimensiones originales de la imagen.
        - `width` number: Ancho en pixeles.
        - `height` number: Alto en pixeles.
      - `resizedData` object: URLs de versiones redimensionadas.
        - `thumbnailURL` string: URL thumbnail.
        - `smallURL` string: URL pequeña.
        - `mediumURL` string: URL mediana.
        - `largeURL` string: URL grande.
        - `extraLargeURL` string: URL extra grande.
    - `image` OrderingImage: Imagen publicada por Justo o por el comercio.
      - `_id` string: ID de la imagen.
      - `url` string: URL original de la imagen.
      - `colorsData` object: Colores calculados de la imagen.
        - `blurhash` string: Blurhash de la imagen.
        - `background` string: Color de fondo sugerido.
        - `front` string: Color frontal sugerido.
      - `dimensions` object: Dimensiones originales de la imagen.
        - `width` number: Ancho en pixeles.
        - `height` number: Alto en pixeles.
      - `resizedData` object: URLs de versiones redimensionadas.
        - `thumbnailURL` string: URL thumbnail.
        - `smallURL` string: URL pequeña.
        - `mediumURL` string: URL mediana.
        - `largeURL` string: URL grande.
        - `extraLargeURL` string: URL extra grande.
    - `cityId` string: ID de la ciudad marketplace.
    - `cookingTime` number: Tiempo estimado de cocina en minutos.
    - `currentDeliveryDuration` number: Duración actual de despacho en minutos.
    - `currentPickupDuration` number: Duración actual de retiro en minutos.
    - `address` OrderingStoreAddress: Dirección pública de un local.
      - `placeId` string: Place ID del local.
      - `streetAddress` string: Dirección principal.
      - `extendedAddress` string, nullable: Dirección extendida.
      - `location` OrderingLocation: Coordenadas geográficas.
        - `lat` number: Latitud.
        - `lng` number: Longitud.
      - `locality` string, nullable: Localidad o comuna.
      - `countryName` string, nullable: País.
    - `disableNowOrders` boolean: Indica si no acepta pedidos para ahora.
    - `closedMessage` string, nullable: Mensaje de cierre, si el local está cerrado.
    - `dataForPlace` object: Datos calculados para el placeId consultado.
      - `distance` number: Distancia al placeId consultado en metros.
      - `orderDuration` number: Duración estimada total del pedido en minutos.
      - `outOfBounds` boolean: Indica si el placeId está fuera de cobertura.
    - `featuredProducts` OrderingFeaturedProduct[]: Productos destacados del comercio.
      - `_id` string: ID del producto.
      - `name` string: Nombre del producto.
      - `image` OrderingImage: Imagen publicada por Justo o por el comercio.
        - `_id` string: ID de la imagen.
        - `url` string: URL original de la imagen.
        - `colorsData` object: Colores calculados de la imagen.
          - `blurhash` string: Blurhash de la imagen.
          - `background` string: Color de fondo sugerido.
          - `front` string: Color frontal sugerido.
        - `dimensions` object: Dimensiones originales de la imagen.
          - `width` number: Ancho en pixeles.
          - `height` number: Alto en pixeles.
        - `resizedData` object: URLs de versiones redimensionadas.
          - `thumbnailURL` string: URL thumbnail.
          - `smallURL` string: URL pequeña.
          - `mediumURL` string: URL mediana.
          - `largeURL` string: URL grande.
          - `extraLargeURL` string: URL extra grande.
      - `price` number, nullable: Precio final.
      - `basePrice` number, nullable: Precio base antes de descuentos.
      - `available` boolean: Indica si está disponible.
      - `notAvailableMessage` string, nullable: Motivo de no disponibilidad.
      - `path` string: Path del producto dentro del website.
    - `matchedProducts` object[]: Productos que coincidieron con una búsqueda marketplace.
      - `_id` string: ID del producto.
      - `name` string: Nombre del producto.
      - `thumbnailURL` string: URL thumbnail del producto.

## Other responses

- `400`: Invalid request
- `401`: Invalid bearer token
- `404`: Resource not found

## Changes

- **2026-06-02** `21cf8d7bd279`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/ordering/customers/:externalCustomerId/marketplace/recommendations/get.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)
