Fórmulas JAGUAR_*

31 fórmulas personalizadas para consultar datos de Mercado Libre en tiempo real desde Google Sheets.

Datos de publicación

fx=JAGUAR_ITEM(item_id, property)Propiedad de la publicación

Devuelve información relacionada a la publicación, como imagen, precio, título, etc.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`property`	req	Propiedad de la publicación	`title, price, base_price, initial_quantity, available_quantity, sold_quantity, permalink, secure_thumbnail, status, warranty, seller_custom_field, health, category_id`

Ejemplos

=JAGUAR_ITEM("MLA000000000", "secure_thumbnail")URL de la imagen principal; combinable con =IMAGE()

=JAGUAR_ITEM("MLA000000000", "sold_quantity")Cantidad vendida

=JAGUAR_ITEM("MLA000000000", "health")Salud de la publicación

fx=JAGUAR_ITEMATTR(item_id, attribute)Atributo de la publicación

Devuelve el valor de un atributo de la publicación. Los atributos disponibles dependen de la categoría.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`attribute`	req	ID o nombre del atributo	`SELLER_SKU, COLOR, DETAILED_MODEL, BRAND, ...`

Ejemplos

=JAGUAR_ITEMATTR("MLA000000000", "SELLER_SKU")SKU de la publicación

=JAGUAR_ITEMATTR("MLA000000000", "COLOR")Color de la publicación

fx=JAGUAR_ITEMCATEGORY(item_id, return_style?)Categoría de la publicación

Devuelve la categoría o el árbol de categorías de la publicación.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`return_style`	opt	Estilo de retorno	`full (default), inner`

Ejemplos

=JAGUAR_ITEMCATEGORY("MLA000000000")Árbol completo: "Bebés > Paseo del Bebé > Huevitos y Sillitas"

=JAGUAR_ITEMCATEGORY("MLA000000000", "inner")Solo la categoría más específica

fx=JAGUAR_ITEMESTFEE(item_id, return_style?)Comisión estimada

Devuelve la comisión estimada de la publicación por listado y por venta.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`return_style`	opt	Qué comisión devolver	`full (default), sale, listing`

Ejemplos

=JAGUAR_ITEMESTFEE("MLA000000000")Comisión por venta + costo por publicar

=JAGUAR_ITEMESTFEE("MLA000000000", "sale")Solo la comisión por venta

fx=JAGUAR_ITEMVISITS(item_id, last_number_days?, start_date?, end_date?)Visitas de la publicación

Devuelve el número de visitas. Podés obtener el total, los últimos X días o un rango de fechas.

Parámetro		Descripción
`item_id`	req	ID de la publicación
`last_number_days`	opt	Cantidad de días
`start_date`	opt	Fecha de inicio
`end_date`	opt	Fecha de fin

Ejemplos

=JAGUAR_ITEMVISITS("MLA000000000")Total de visitas

=JAGUAR_ITEMVISITS("MLA000000000", 15)Visitas en los últimos 15 días

=JAGUAR_ITEMVISITS("MLA000000000", , "2025-01-01", "2025-01-31")Visitas en un rango de fechas

fx=JAGUAR_ITEMQUESTIONS(item_id)Total de preguntas

Devuelve el número total de preguntas que recibió la publicación.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_ITEMQUESTIONS("MLA000000000")Total de preguntas de la publicación

fx=JAGUAR_ITEMRATINGAVRG(item_id)Promedio de opiniones

Devuelve el promedio de las opiniones de los compradores.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_ITEMRATINGAVRG("MLA000000000")Promedio de opiniones

fx=JAGUAR_ITEMIMGQA(item_id, return_style?)Calidad de imágenes

Devuelve el estado general de calidad de las imágenes o un listado de condiciones.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`return_style`	opt	Qué devolver	`quality (default), conditions`

Ejemplos

=JAGUAR_ITEMIMGQA("MLA000000000")Estado de calidad, ej. "good"

=JAGUAR_ITEMIMGQA("MLA000000000", "conditions")Listado de condiciones (minimum_size, logo_text_watermark, etc.)

fx=JAGUAR_ITEMIMGMESSAGE(item_id)Mensaje de calidad de imagen

Devuelve un mensaje detallando el estado actual de la calidad de las imágenes.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_ITEMIMGMESSAGE("MLA000000000")Mensaje con el estado de las imágenes

fx=JAGUAR_ITEMPERFORMANCE(item_id)Calidad de la publicación

Devuelve el score de calidad de la publicación (0-100).

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_ITEMPERFORMANCE("MLA000000000")Score de calidad, ej. 80

fx=JAGUAR_ITEMFLEX(item_id)Estado de Flex

Devuelve si la publicación tiene Mercado Envíos Flex activado.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_ITEMFLEX("MLA000000000")TRUE si Flex está activado

fx=JAGUAR_INVENTORY(item_id, variation_id?, status?)Stock disponible

Stock disponible de una publicación o variación específica. Sirve para verificar stock disponible y no disponible cuando la publicación es Full.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`variation_id`	opt	ID de la variación
`status`	opt	Estado del stock (solo para Full)	`available (default), not_available`

Ejemplos

=JAGUAR_INVENTORY("MLA000000000")Inventario disponible total

=JAGUAR_INVENTORY("MLA000000000", "00000000000")Inventario de la variación

=JAGUAR_INVENTORY("MLA000000000", "00000000000", "not_available")Inventario NO disponible en Full

fx=JAGUAR_INFRACTIONS(item_id)Infracciones

Devuelve las infracciones con la razón y el remedio de la publicación.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_INFRACTIONS("MLA000000000")Lista de dos columnas: razón y remedio

Variaciones

fx=JAGUAR_VARIAATTR(item_id, variation_id?, attribute)Atributo de variación

Devuelve el valor de un atributo de la variación. Si no se especifica variación, busca en la publicación.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`variation_id`	opt	ID de la variación (si se omite, busca en la publicación)
`attribute`	req	ID o nombre del atributo	`SELLER_SKU, COLOR, DETAILED_MODEL, ...`

Ejemplos

=JAGUAR_VARIAATTR("MLA000000000", "00000000000", "SELLER_SKU")SKU de la variación

=JAGUAR_VARIAATTR("MLA000000000", "00000000000", "COLOR")Color de la variación

Catálogo y Buy Box

fx=JAGUAR_CATALOGSTATUS(item_id)Estado en catálogo

Devuelve el estado de la publicación en catálogo.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_CATALOGSTATUS("MLA000000000")Estado de la publicación en catálogo

fx=JAGUAR_CATALOGCURPRICE(item_id)Precio en catálogo

Devuelve el precio de la publicación que está compitiendo en catálogo.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_CATALOGCURPRICE("MLA000000000")Precio de competencia en catálogo

fx=JAGUAR_CATALOGWINPRICE(item_id)Precio para ganar

Devuelve el precio necesario para que la publicación gane en catálogo.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_CATALOGWINPRICE("MLA000000000")Precio necesario para ganar el Buy Box

fx=JAGUAR_CATALOGBOOSTS(item_id)Acciones de impulso

Devuelve las acciones disponibles para impulsar la publicación en catálogo.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_CATALOGBOOSTS("MLA000000000")Acciones para ganar el listado en catálogo

fx=JAGUAR_CATALOGREASONS(item_id)Razones de no competir

Devuelve las razones por las cuales la publicación no está compitiendo en catálogo.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_CATALOGREASONS("MLA000000000")Razones por las que no compite

Ventas

fx=JAGUAR_SALESCOUNT(period, item_id, variation_id?, status?, start_date?, end_date?)Unidades vendidas

Devuelve el total de unidades vendidas en un período determinado. Soporta solo los últimos 12 meses.

Parámetro		Descripción	Valores
`period`	req	Período de tiempo	`Custom, Hoy, Ayer, Mismo dia semana pasada, Mismo dia mes pasado, Ultimos 7 dias, Ultimos 14 dias, Ultimos 30 dias, Ultimos 60 dias, Esta semana, Este mes, Semana pasada, Mes pasado, Ultimos 12 meses`
`item_id`	req	ID de la publicación
`variation_id`	opt	ID de la variación
`status`	opt	Estado de la orden	`paid (default), cancelled`
`start_date`	opt	Fecha de inicio para Custom (YYYY-MM-DD)
`end_date`	opt	Fecha de fin para Custom (YYYY-MM-DD)

Ejemplos

=JAGUAR_SALESCOUNT("Ultimos 30 dias", "MLA000000000")Unidades vendidas en los últimos 30 días

=JAGUAR_SALESCOUNT("Este mes", "MLA000000000", , "cancelled")Órdenes canceladas este mes

=JAGUAR_SALESCOUNT("Custom", "MLA000000000", , , "2025-01-01", "2025-01-31")Ventas en un rango de fechas

fx=JAGUAR_SALESTOTAL(period, item_id, variation_id?, status?, start_date?, end_date?)Facturación

Devuelve la cifra de ventas (monto) en un período determinado. Soporta solo los últimos 12 meses.

Parámetro		Descripción	Valores
`period`	req	Período de tiempo	`Custom, Hoy, Ayer, Mismo dia semana pasada, Mismo dia mes pasado, Ultimos 7 dias, Ultimos 14 dias, Ultimos 30 dias, Ultimos 60 dias, Esta semana, Este mes, Semana pasada, Mes pasado, Ultimos 12 meses`
`item_id`	req	ID de la publicación
`variation_id`	opt	ID de la variación
`status`	opt	Estado de la orden	`paid (default), cancelled`
`start_date`	opt	Fecha de inicio para Custom (YYYY-MM-DD)
`end_date`	opt	Fecha de fin para Custom (YYYY-MM-DD)

Ejemplos

=JAGUAR_SALESTOTAL("Este mes", "MLA000000000")Facturación del mes

=JAGUAR_SALESTOTAL("Ultimos 12 meses", "MLA000000000")Facturación del último año

=JAGUAR_SALESTOTAL("Custom", "MLA000000000", , , "2025-01-01", "2025-01-31")Facturación en un rango de fechas

Listados

fx=JAGUAR_ITEMLIST(seller_sku?, status?, logistic_type?, catalog_listing?, include_variations?)Listado de publicaciones

Devuelve una lista de dos columnas con los IDs de publicaciones y sus variaciones.

Parámetro		Descripción	Valores
`seller_sku`	opt	Filtrar por SKU del vendedor
`status`	opt	Filtrar por estado	`pending, not_yet_active, programmed, active, paused, closed`
`logistic_type`	opt	Filtrar por tipo logístico	`cross_docking, fulfillment, not_specified`
`catalog_listing`	opt	Filtrar por estado en catálogo	`all (default), true, false`
`include_variations`	opt	Incluir variaciones	`true (default), false`

Ejemplos

=JAGUAR_ITEMLIST()Todas las publicaciones

=JAGUAR_ITEMLIST("SKU_123")Publicaciones cuyo SKU empieza con "SKU_123"

=JAGUAR_ITEMLIST(, "active")Solo publicaciones activas

=JAGUAR_ITEMLIST(, , "fulfillment")Solo publicaciones Full

Inteligencia de mercado

fx=JAGUAR_BESTSELLERS(site_id, category_id)Top 20 más vendidos

Consulta el top 20 de items/productos de una categoría específica.

Parámetro		Descripción	Valores
`site_id`	req	Sitio (MLA, MLB, MLM, etc.)
`category_id`	req	ID de la categoría

Ejemplos

=JAGUAR_BESTSELLERS("MLA", "MLA1384")Top 20 más vendidos de la categoría

fx=JAGUAR_BESTSELLERSPOS(site_id, item_id)Posición en más vendidos

Consulta la posición de un item en la lista de más vendidos.

Parámetro		Descripción	Valores
`site_id`	req	Sitio (MLA, MLB, MLM, etc.)
`item_id`	req	ID de la publicación

Ejemplos

=JAGUAR_BESTSELLERSPOS("MLA", "MLA15993172")Posición del item en más vendidos

fx=JAGUAR_TRENDS(site_id?, category_id?)Tendencias

Devuelve el listado de tendencias y links según país y categoría.

Parámetro		Descripción	Valores
`site_id`	opt	Sitio (MLA, MLB, etc.). Default: tu cuenta
`category_id`	opt	ID de la categoría (opcional)

Ejemplos

=JAGUAR_TRENDS()Tendencias de tu país

=JAGUAR_TRENDS("MLB")Tendencias de Brasil

=JAGUAR_TRENDS(, "MLA1386")Tendencias de una categoría específica

fx=JAGUAR_CATATTR(category_id)Atributos de categoría

Devuelve los atributos disponibles de una categoría.

Parámetro		Descripción	Valores
`category_id`	req	ID de la categoría

Ejemplos

=JAGUAR_CATATTR("MLA1386")Atributos de la categoría

Vendedor

fx=JAGUAR_RESPTIME(return_style?, property?)Tiempo de respuesta

Consulta el tiempo de respuesta a preguntas o el potencial de aumento de ventas.

Parámetro		Descripción	Valores
`return_style`	opt	Segmento de tiempo	`total (default), weekend, weekdays_working_hours, weekdays_extra_hours`
`property`	opt	Qué devolver	`response_time (default, en minutos), sales_percent_increase`

Ejemplos

=JAGUAR_RESPTIME()Tiempo de respuesta total (minutos)

=JAGUAR_RESPTIME("weekend")Tiempo de respuesta en fin de semana

=JAGUAR_RESPTIME("weekend", "sales_percent_increase")Potencial de aumento de ventas en fin de semana

Parámetro		Descripción	Valores
`status`	opt	Filtrar por estado	`active, paused`

Parámetro		Descripción	Valores
`campaign_id`	req	ID numérico de la campaña
`property`	req	Propiedad o métrica	`name, status, strategy, budget, currency_id, clicks, prints, cost, cpc, acos, roas, ctr, cvr, sov, direct_amount, indirect_amount, total_amount`
`date_from`	opt	Fecha o período predefinido	`YYYY-MM-DD, last30Days, thisMonth, ...`
`date_to`	opt	Fecha de fin (YYYY-MM-DD)

Ejemplos

=JAGUAR_ADCAMPAIGN(123456, "name")Nombre de la campaña

=JAGUAR_ADCAMPAIGN(123456, "clicks", "last30Days")Clicks en los últimos 30 días

=JAGUAR_ADCAMPAIGN(123456, "acos", "2026-01-01", "2026-01-31")ACOS de enero 2026

fx=JAGUAR_ADMETRICS(item_id, metric, date_from?, date_to?)Métricas por publicación

Devuelve métricas publicitarias de una publicación específica.

Parámetro		Descripción	Valores
`item_id`	req	ID de la publicación
`metric`	req	Campo o métrica	`status, campaign_id, clicks, prints, cost, cpc, acos, roas, ctr, cvr, direct_items_quantity, indirect_items_quantity, organic_units_quantity, direct_amount, indirect_amount, total_amount`
`date_from`	opt	Fecha o período predefinido	`YYYY-MM-DD, last30Days, thisMonth, ...`
`date_to`	opt	Fecha de fin (YYYY-MM-DD)

Ejemplos

=JAGUAR_ADMETRICS("MLA123456", "clicks", "last30Days")Clicks del anuncio en los últimos 30 días

=JAGUAR_ADMETRICS("MLA123456", "acos", "thisMonth")ACOS del anuncio este mes

=JAGUAR_ADMETRICS("MLA123456", "status")Estado del anuncio (active, paused, idle)

fx=JAGUAR_ADSUMMARY(metric, date_from, date_to?)Resumen de publicidad

Devuelve el total de una métrica publicitaria a nivel de toda la cuenta.

Parámetro		Descripción	Valores
`metric`	req	Métrica	`clicks, prints, cost, cpc, acos, roas, ctr, cvr, sov, direct_amount, indirect_amount, total_amount`
`date_from`	req	Fecha o período predefinido	`YYYY-MM-DD, last30Days, thisMonth, ...`
`date_to`	opt	Fecha de fin (YYYY-MM-DD)

Ejemplos

=JAGUAR_ADSUMMARY("cost", "thisMonth")Inversión total este mes

=JAGUAR_ADSUMMARY("roas", "last30Days")ROAS de los últimos 30 días

=JAGUAR_ADSUMMARY("clicks", "2026-01-01", "2026-01-31")Total de clicks en enero 2026

Fórmulas JAGUAR_*

Datos de publicación

Variaciones

Catálogo y Buy Box

Ventas

Listados

Inteligencia de mercado

Vendedor

Publicidad