Mercado Libre - Get User

Description

This module allows querying user information, either the authenticated user (your account) or public information of other users such as buyers or sellers.

Configuration

Credentials

This module requires Mercado Libre (OAuth) credentials with the following fields:

Field	Description
`access_token`	Valid OAuth access token

Parameters

Field	Type	Required	Description
`credentials_id`	string	Yes	Credentials ID
`user_id`	string	No	User ID to query
`get_me`	boolean	No	Get authenticated user
`include_reputation`	boolean	No	Include reputation data
`include_address`	boolean	No	Include addresses (own only)

Output

{
  "success": true,
  "user": {...},
  "user_id": 123456789,
  "nickname": "VENDEDOR_PRO",
  "email": "vendedor@email.com",
  "first_name": "Juan",
  "last_name": "Perez",
  "country_id": "AR",
  "seller_reputation": {
    "level_id": "5_green",
    "power_seller_status": "platinum",
    "transactions": {
      "completed": 1500,
      "canceled": 10
    }
  },
  "message": "User VENDEDOR_PRO retrieved successfully"
}

Usage Example

Get my information

{
  "credentials_id": "meli_cuenta",
  "get_me": true
}

Get user by ID

{
  "credentials_id": "meli_cuenta",
  "user_id": "123456789"
}

My information with reputation

{
  "credentials_id": "meli_cuenta",
  "get_me": true,
  "include_reputation": true
}

My information with addresses

{
  "credentials_id": "meli_cuenta",
  "get_me": true,
  "include_address": true
}

Full account information

{
  "credentials_id": "meli_cuenta",
  "get_me": true,
  "include_reputation": true,
  "include_address": true
}

User Fields

Field	Description
`id`	Unique user ID
`nickname`	Public username
`email`	Email (own user only)
`first_name`	First name
`last_name`	Last name
`country_id`	Country (AR, MX, BR, etc.)
`site_id`	Site (MLA, MLM, MLB, etc.)
`seller_reputation`	Seller reputation
`buyer_reputation`	Buyer reputation
`status`	Account status
`user_type`	User type

Reputation Levels

Level	Color	Description
`1_red`	Red	Very low reputation
`2_orange`	Orange	Low reputation
`3_yellow`	Yellow	Average reputation
`4_light_green`	Light green	Good reputation
`5_green`	Green	Excellent reputation

Power Seller Status

Status	Description
`gold`	Gold Seller
`platinum`	Platinum Seller
`null`	No qualification

Example Workflows

Verify buyer reputation

[Order received] -> [MeliGetUser buyer_id] -> [Evaluate risk] -> [Decide action]

Own reputation monitor

[Daily schedule] -> [MeliGetUser me + reputation] -> [Check changes] -> [Alert]

Get data for billing

[Paid order] -> [MeliGetUser] -> [MeliGetUser address] -> [Generate invoice]

Usage with ExecuteScript

// Evaluate buyer risk
const comprador = ctx.data.user;

let riesgo = 'bajo';
let notas = [];

// Check reputation
const reputacion = comprador.buyer_reputation;
if (!reputacion) {
  riesgo = 'medio';
  notas.push('Sin historial de compras');
} else if (reputacion.canceled_transactions > 3) {
  riesgo = 'alto';
  notas.push(`${reputacion.canceled_transactions} compras canceladas`);
}

// Check account age
const fechaRegistro = new Date(comprador.registration_date);
const diasRegistro = (Date.now() - fechaRegistro) / (1000 * 60 * 60 * 24);
if (diasRegistro < 30) {
  riesgo = riesgo === 'bajo' ? 'medio' : 'alto';
  notas.push('Cuenta nueva (< 30 dias)');
}

ctx.data = {
  buyer_id: comprador.id,
  nickname: comprador.nickname,
  nivel_riesgo: riesgo,
  notas: notas,
  aprobar_automatico: riesgo === 'bajo'
};

API Used

API: Mercado Libre Users API
Endpoint: GET /users/me, GET /users/{id}
Documentation: https://developers.mercadolibre.com/

Notes

Email is only available for the authenticated user
Addresses are only available for the own user
Other users’ information is public and limited
Seller reputation includes sales metrics
Buyer reputation includes purchase metrics

MeliGetOrders - Get user orders
MeliGetItems - Get seller items
MeliGetQuestions - Get user questions