> ## Documentation Index
> Fetch the complete documentation index at: https://support.detrics.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Mercado Libre Organic Metrics & Dimensions
> Complete reference for Mercado Libre Organic dimensions and metrics
**Last updated:** July 17, 2026
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 |
***
## Related
Browse all platforms
Mercado Ads metrics & dimensions
TiendaNube metrics & dimensions
Shopify metrics & dimensions