Mercado Libre Organic Metrics & Dimensions

Last updated: June 16, 2026

73 dimensions

51 metrics

This reference covers all available dimensions and metrics for Mercado Libre Organic data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

Supported destinations:

Google Sheets

Claude

BigQuery

Dimensions

Dimensions are the attributes you can use to segment and group your Mercado Libre Organic data.

Account


Account ID	Mercado Libre seller ID. Field Name: `accountId` Type: dimension
Account Name	Mercado Libre seller display name / nickname. Field Name: `accountName` Type: dimension

Reputation


Country	Seller country (AR, BR, MX, etc.). Field Name: `countryId` Type: dimension
Site	Mercado Libre site identifier (e.g., MLA for Argentina, MLB for Brazil, MLM for Mexico). Field Name: `siteId` Type: dimension
Seller Experience	Seller experience level: NEWBIE, INTERMEDIATE, or ADVANCED. Field Name: `sellerExperience` Type: dimension
Reputation Level	Seller reputation level (1_red, 2_orange, 3_yellow, 4_light_green, 5_green). Field Name: `reputationLevel` Type: dimension
Power Seller Status	MercadoLíder/Líder status: silver, gold, platinum, or null. Field Name: `powerSellerStatus` Type: dimension
Registration Date	Date the seller account was created. Field Name: `registrationDate` Type: dimension
User Type	Account type: brand, normal, etc. Field Name: `userType` Type: dimension
User Tags	Comma-separated tags describing the seller (e.g., business, eshop, large_seller). Field Name: `userTags` Type: dimension
Seller Profile URL	Public URL of the seller profile on Mercado Libre. Field Name: `sellerProfileUrl` Type: dimension
Credit Level	Mercado Libre credit level identifier. Field Name: `creditLevelId` Type: dimension
Credit Rank	Credit rank: newbie, regular, top, etc. Field Name: `creditRank` Type: dimension
Mercado Envíos Status	Whether the seller accepts Mercado Envíos shipping (accepted, not_accepted). Field Name: `mercadoEnviosStatus` Type: dimension
Mercado Pago Account Type	Mercado Pago account type: personal, business. Field Name: `mercadopagoAccountType` Type: dimension
Site Status	Account status on the site: active, inactive, etc. Field Name: `siteStatus` Type: dimension

Items


Item ID	Mercado Libre listing ID (e.g., MLA1234567890). Field Name: `itemId` Type: dimension
Item Title	Title of the listing. Field Name: `itemTitle` Type: dimension
Item Subtitle	Optional subtitle of the listing. Field Name: `itemSubtitle` Type: dimension
Item Category	Mercado Libre category identifier (e.g., MLA417376). Field Name: `itemCategoryId` Type: dimension
Item Domain	Item domain identifier (e.g., MLA-SPORT_BRAS). Field Name: `itemDomainId` Type: dimension
Official Store ID	Official store ID if the listing belongs to one. Field Name: `itemOfficialStoreId` Type: dimension
Catalog Product ID	Mercado Libre catalog product identifier if catalog-listed. Field Name: `itemCatalogProductId` Type: dimension
Item Condition	Item condition: new, used, refurbished. Field Name: `itemCondition` Type: dimension
Item Status	Listing status: active, paused, closed. Field Name: `itemStatus` Type: dimension
Item Sub-status	Sub-status (e.g., out_of_stock, under_review). Field Name: `itemSubStatus` Type: dimension
Item Listing Type	Listing type: gold_special, gold_pro, etc. Field Name: `itemListingTypeId` Type: dimension
Buying Mode	Buying mode: buy_it_now, auction, classified. Field Name: `itemBuyingMode` Type: dimension
Item Currency	Currency the listing is priced in (e.g., ARS, BRL, MXN). Field Name: `itemCurrencyId` Type: dimension
Item URL	Public URL of the listing on Mercado Libre. Field Name: `itemPermalink` Type: dimension
Item Thumbnail	URL of the listing thumbnail image. Field Name: `itemThumbnail` Type: dimension
Item Date Created	Date the listing was created. Field Name: `itemDateCreated` Type: dimension
Item Last Updated	Date the listing was last updated. Field Name: `itemLastUpdated` Type: dimension
Item Start Time	Date the listing started. Field Name: `itemStartTime` Type: dimension
Item Stop Time	Date the listing is scheduled to stop. Field Name: `itemStopTime` Type: dimension
Shipping Mode	Shipping mode (e.g., me2, custom). Field Name: `itemShippingMode` Type: dimension
Shipping Logistic Type	Shipping logistic type (e.g., xd_drop_off, fulfillment). Field Name: `itemShippingLogisticType` Type: dimension
Item Tags	Comma-separated listing tags (e.g., good_quality_thumbnail, cart_eligible). Field Name: `itemTags` Type: dimension
Item Warranty	Warranty terms declared by the seller. Field Name: `itemWarranty` Type: dimension
Parent Item ID	Parent item ID if this listing is a variation child. Field Name: `itemParentItemId` Type: dimension

Orders


Order ID	Mercado Libre order identifier. Field Name: `orderId` Type: dimension
Pack ID	Pack identifier (groups multiple orders sharing the same buyer + shipment). Field Name: `packId` Type: dimension
Order Status	Order status: paid, confirmed, cancelled, etc. Field Name: `orderStatus` Type: dimension
Order Date Created	Date the order was created. Field Name: `orderDateCreated` Type: dimension
Order Date Closed	Date the order was closed (payment captured). Field Name: `orderDateClosed` Type: dimension
Order Last Updated	Date the order was last updated. Field Name: `orderLastUpdated` Type: dimension
Order Expiration Date	Date the order expires if unpaid. Field Name: `orderExpirationDate` Type: dimension
Order Currency	Currency used for the order. Field Name: `orderCurrencyId` Type: dimension
Order Tags	Comma-separated order tags (e.g., d2c, pack_order, paid, delivered). Field Name: `orderTags` Type: dimension
Buyer ID	Mercado Libre buyer identifier. Field Name: `orderBuyerId` Type: dimension
Pickup ID	Pickup identifier when shipping mode uses store pickup. Field Name: `orderPickupId` Type: dimension
Shipping ID	Shipment identifier (can be joined with Mercado Envíos shipping data). Field Name: `orderShippingId` Type: dimension
Order Comment	Optional buyer comment attached to the order. Field Name: `orderComment` Type: dimension
Feedback — Purchase Rating	Buyer-given feedback rating on the purchase (positive/neutral/negative). Field Name: `orderFeedbackPurchaseRating` Type: dimension
Feedback — Sale Rating	Seller-given feedback rating on the sale. Field Name: `orderFeedbackSaleRating` Type: dimension
Coupon ID	Mercado Libre coupon ID applied to the order, if any. Field Name: `orderCouponId` Type: dimension
Payment Method	First payment’s method identifier (e.g., account_money, visa). Field Name: `orderPaymentMethodId` Type: dimension
Payment Type	First payment’s type (e.g., account_money, credit_card, ticket). Field Name: `orderPaymentType` Type: dimension
Payment Status	First payment’s status (approved, pending, rejected). Field Name: `orderPaymentStatus` Type: dimension
Payment Date Approved	Date the payment was approved. Field Name: `orderPaymentDateApproved` Type: dimension
First Item Title	Title of the first item in the order. Field Name: `orderFirstItemTitle` Type: dimension
First Item Category	Category identifier of the first item in the order. Field Name: `orderFirstItemCategoryId` Type: dimension

Questions


Question ID	Mercado Libre question identifier. Field Name: `questionId` Type: dimension
Question Item ID	Listing the question was asked about. Field Name: `questionItemId` Type: dimension
Question Status	Question status: ANSWERED, UNANSWERED, BANNED, DELETED, CLOSED_UNANSWERED. Field Name: `questionStatus` Type: dimension
Question Text	The buyer-written question. Field Name: `questionText` Type: dimension
Question Date Created	Date the question was created. Field Name: `questionDateCreated` Type: dimension
Question Answer Text	The seller-written answer text. Field Name: `questionAnswerText` Type: dimension
Question Answer Date	Date the answer was posted. Field Name: `questionAnswerDate` Type: dimension
Question From User ID	ID of the buyer who asked the question. Field Name: `questionFromUserId` Type: dimension
Question Answer Status	Answer status: ACTIVE, BANNED, DELETED, DISABLED. Field Name: `questionAnswerStatus` Type: dimension
Question Tags	Comma-separated tags on the question. Field Name: `questionTags` Type: dimension
Question Deleted From Listing	1 if the question is hidden from the listing page, 0 otherwise. Field Name: `questionDeletedFromListing` Type: dimension

Metrics

Metrics are the numerical values you can measure and analyze from your Mercado Libre Organic campaigns.

Questions


Question Answered	1 if the question has been answered, 0 otherwise. Sum across rows for count of answered questions. Field Name: `questionAnswered` Type: metric

Reputation


User Points	Seller reputation points. Field Name: `userPoints` Type: metric
Total Transactions	Total historic transactions (canceled + completed). Field Name: `totalTransactions` Type: metric
Completed Transactions	Historic completed transactions count. Field Name: `completedTransactions` Type: metric
Canceled Transactions	Historic canceled transactions count. Field Name: `canceledTransactions` Type: metric
Positive Ratings	Historic positive ratings received. Field Name: `positiveRatings` Type: metric
Neutral Ratings	Historic neutral ratings received. Field Name: `neutralRatings` Type: metric
Negative Ratings	Historic negative ratings received. Field Name: `negativeRatings` Type: metric
Sales Completed (Last 365d)	Completed sales in the rolling last 365 days. Field Name: `salesCompletedLast365Days` Type: metric
Claims Rate	Share of orders with buyer claims (last 60 days). Field Name: `claimsRate` Type: metric
Claims Value	Count of orders with claims (last 60 days). Field Name: `claimsValue` Type: metric
Delayed Handling Time Rate	Share of orders with delayed handling (last 60 days). Field Name: `delayedHandlingTimeRate` Type: metric
Delayed Handling Time Value	Count of orders with delayed handling (last 60 days). Field Name: `delayedHandlingTimeValue` Type: metric
Cancellations Rate	Share of orders cancelled by the seller (last 60 days). Field Name: `cancellationsRate` Type: metric
Cancellations Value	Count of seller-cancelled orders (last 60 days). Field Name: `cancellationsValue` Type: metric
Confirmed Email	1 if the seller email is confirmed, 0 otherwise. Field Name: `confirmedEmail` Type: metric

Items


Item Health	Mercado Libre listing health score (0-1). Indicates how well-completed the listing is. Field Name: `itemHealth` Type: metric
Item Price	Current listing price. Field Name: `itemPrice` Type: metric
Item Base Price	Base price before any discounts applied. Field Name: `itemBasePrice` Type: metric
Item Original Price	Original listing price before promotional discounts. Field Name: `itemOriginalPrice` Type: metric
Available Quantity	Current stock available for the listing. Field Name: `itemAvailableQuantity` Type: metric
Sold Quantity	Lifetime units sold for the listing. Field Name: `itemSoldQuantity` Type: metric
Initial Quantity	Initial stock of the listing when first published. Field Name: `itemInitialQuantity` Type: metric
Catalog Listing	1 if the listing is part of a Mercado Libre catalog, 0 otherwise. Field Name: `itemCatalogListing` Type: metric
Accepts Mercado Pago	1 if the listing accepts Mercado Pago, 0 otherwise. Field Name: `itemAcceptsMercadoPago` Type: metric
Free Shipping	1 if the listing offers free shipping, 0 otherwise. Field Name: `itemFreeShipping` Type: metric
Automatic Relist	1 if the listing is configured to auto-relist, 0 otherwise. Field Name: `itemAutomaticRelist` Type: metric
Item Picture Count	Number of pictures attached to the listing. Field Name: `itemPictureCount` Type: metric
Item Variation Count	Number of variations (e.g., size/color combinations) on the listing. Field Name: `itemVariationCount` Type: metric
Item Visits	Lifetime visits to the listing (last ~150 days, ML API limit). Field Name: `itemVisits` Type: metric

Reviews


Reviews Total	Total reviews submitted for the listing. Field Name: `reviewsTotal` Type: metric
Reviews Rating Average	Average rating across all reviews (0-5). Field Name: `reviewsRatingAverage` Type: metric
Reviews With Comment	Number of reviews that include a written comment. Field Name: `reviewsWithComment` Type: metric
Reviews — 5 Stars	Count of 5-star reviews. Field Name: `reviewsFiveStars` Type: metric
Reviews — 4 Stars	Count of 4-star reviews. Field Name: `reviewsFourStars` Type: metric
Reviews — 3 Stars	Count of 3-star reviews. Field Name: `reviewsThreeStars` Type: metric
Reviews — 2 Stars	Count of 2-star reviews. Field Name: `reviewsTwoStars` Type: metric
Reviews — 1 Star	Count of 1-star reviews. Field Name: `reviewsOneStar` Type: metric

Orders


Order Total Amount	Total monetary value of the order. Field Name: `orderTotalAmount` Type: metric
Order Paid Amount	Amount actually paid by the buyer. Field Name: `orderPaidAmount` Type: metric
Order Shipping Cost	Shipping cost reported on the first payment. Field Name: `orderShippingCost` Type: metric
Order Items Count	Number of distinct items in the order. Field Name: `orderItemsCount` Type: metric
Order Total Quantity	Sum of unit quantities across all items in the order. Field Name: `orderTotalQuantity` Type: metric
Coupon Amount	Coupon discount amount applied to the order. Field Name: `orderCouponAmount` Type: metric
Payment Installments	Number of installments on the first payment. Field Name: `orderPaymentInstallments` Type: metric
Payment Marketplace Fee	Mercado Pago marketplace fee on the first payment. Field Name: `orderPaymentMarketplaceFee` Type: metric
Payment Taxes Amount	Taxes amount reported on the first payment. Field Name: `orderPaymentTaxesAmount` Type: metric
First Item Unit Price	Unit price of the first item in the order. Field Name: `orderFirstItemUnitPrice` Type: metric
First Item Sale Fee	Mercado Libre commission charged on the first item. Field Name: `orderFirstItemSaleFee` Type: metric
Order Total Sale Fee	Total Mercado Libre commission charged across all items in the order. Field Name: `orderTotalSaleFee` Type: metric

Seller Visits


Seller Total Visits	Total visits to the seller’s storefront in the selected date range. Mercado Libre only returns the aggregate value, so this metric requires the ‘All’ time aggregation. Field Name: `sellerTotalVisits` Type: metric

Fields Catalog

Browse all platforms

Mercado Ads Fields

Mercado Ads metrics & dimensions

TiendaNube Fields

TiendaNube metrics & dimensions

Shopify Fields

Shopify metrics & dimensions

​Dimensions

​Account

​Reputation

​Items

​Orders

​Questions

​Metrics

​Questions

​Reputation

​Items

​Reviews

​Orders

​Seller Visits

​Related

Fields Catalog

Mercado Ads Fields

TiendaNube Fields

Shopify Fields

Dimensions

Account

Reputation

Items

Orders

Questions

Metrics

Questions

Reputation

Items

Reviews

Orders

Seller Visits

Related