Última actualización 15/03/2023

Usuarios y Aplicaciones

Estos ejemplos servirán para trabajar con usuarios y aplicaciones registradas en Mercado Libre.

Recurso	Descripción	Ejemplo
/users/$USER_ID	Información de la cuenta del usuario.	GET PUT Go back X Devuelve información del usuario. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{User_id}` Respuesta { "id": 206946886, "nickname": "TETE6838590", "registration_date": "2016-02-24T15: 18: 42.000-04: 00", "first_name": "Pedro", "last_name": "Picapiedras", "country_id": "AR", "email": "test_user_15879541@testuser.com", "identification": { "type": "DNI", "number": "33333333" }, "address": { "state": "AR-C", "city": "CapitalFederal", "address": "Triunvirato5555", "zip_code": "1414" }, "phone": { "area_code": "011", "number": "4444-4444", "extension": "001", "verified": false }, "alternative_phone": { "area_code": "", "number": "", "extension": "" }, "user_type": "normal", "tags": [ "normal", "test_user", "user_info_verified" ], "logo": null, "points": 100, "site_id": "MLA", "permalink": "http: //perfil.mercadolibre.com.ar/TETE6838590", "seller_experience": "ADVANCED", "seller_reputation": { "level_id": null, "power_seller_status": null, "transactions": { "period": "historic", "total": 0, "completed": 0, "canceled": 0, "ratings": { "positive": 0, "negative": 0, "neutral": 0 } } }, "buyer_reputation": { "canceled_transactions": 0, "transactions": { "period": "historic", "total": null, "completed": null, "canceled": { "total": null, "paid": null }, "unrated": { "total": null, "paid": null }, "not_yet_rated": { "total": null, "paid": null, "units": null } }, "tags": [ ] }, "status": { "site_status": "active", "list": { "allow": true, "codes": [ ], "immediate_payment": { "required": false, "reasons": [ ] } }, "buy": { "allow": true, "codes": [ ], "immediate_payment": { "required": false, "reasons": [ ] } }, "sell": { "allow": true, "codes": [ ], "immediate_payment": { "required": false, "reasons": [ ] } }, "billing": { "allow": true, "codes": [ ] }, "mercadopago_tc_accepted": true, "mercadopago_account_type": "personal", "mercadoenvios": "not_accepted", "immediate_payment": false, "confirmed_email": false, "user_type": "simple_registration", "required_action": "" }, "credit": { "consumed": 100, "credit_level_id": "MLA1" } } Leer más. Go back X Información actualizada de los usuarios. `curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d { "address": "Triunvirato 5555", "state":"AR-C", "city":"Capital Federal", "zip_dode": "1431", "phone":{ "area_code":"011", "number":"4444-4444", "extension":"001" }, "first_name":"Pedro", "last_name": "Picapiedras", "company":{ "corporate_name":"Acme", "brand_name":"Acme Company" }, "mercadoenvios": "accepted" } https://api.mercadolibre.com/users/123456789` Leer más.
/users/me	Devuelve la información del usuario que está logueado en la cuenta.	GET Go back X Devuelve información sobre la autenticación del usuario. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/me` Respuesta { "id": 178553776, "user_id": 206946886, "contact": null, "phone": null, "address_line": "Triunvirato 5555", "floor": null, "apartment": null, "street_number": "5555", "street_name": "Triunvirato", "zip_code": "1414", "city": { "id": "TUxBQlZJTDcwOTla", "name": "Villa Urquiza" }, "state": { "id": "AR-C", "name": "Capital Federal" }, "country": { "id": "AR", "name": "Argentina" }, "neighborhood": { "id": null, "name": null }, "municipality": { "id": null, "name": null }, "search_location": { "state": { "id": "TUxBUENBUGw3M2E1", "name": "Capital Federal" }, "city": { "id": null, "name": null }, "neighborhood": { "id": null, "name": null } }, "types": [ ], "comment": "", "geolocation_type": "ROOFTOP", "latitude": -34.5676878, "longitude": -58.4933182, "status": "active", "date_created": "2016-02-24T16:29:59.000-04:00", "normalized": true, "open_hours": { "on_holidays": { "hours": [ ], "status": "closed" } } } Leer más.
/users/$USER_ID/addresses	Devuelve direcciones asociadas a la cuenta del usuario.	GET Go back X Devuelve la dirección del usuario `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/addresses` Respuesta { "id": 178553776, "user_id": 206946886, "contact": null, "phone": null, "address_line": "Triunvirato5555", "floor": null, "apartment": null, "street_number": "5555", "street_name": "Triunvirato", "zip_code": "1414", "city": { "id": "TUxBQlZJTDcwOTla", "name": "VillaUrquiza" }, "state": { "id": "AR-C", "name": "CapitalFederal" }, "country": { "id": "AR", "name": "Argentina" }, "neighborhood": { "id": null, "name": null }, "municipality": { "id": null, "name": null }, "search_location": { "state": { "id": "TUxBUENBUGw3M2E1", "name": "CapitalFederal" }, "city": { "id": null, "name": null }, "neighborhood": { "id": null, "name": null } }, "types": [ ], "comment": "", "geolocation_type": "ROOFTOP", "latitude": -34.5676878, "longitude": -58.4933182, "status": "active", "date_created": "2016-02-24T16: 29: 59.000-04: 00", "normalized": true, "open_hours": { "on_holidays": { "hours": [ ], "status": "closed" } } } Leer más.
/users/$USER_ID/accepted_payment_methods	Devuelve los métodos de pago aceptados por el vendedor para cobrar.	GET Go back X Devuelve los métodos de pagos aceptados por usuario. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/accepted_payment_methods` Respuesta { "id": "visa", "name": "Visa", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/visa.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/visa.gif" }, { "id": "master", "name": "Mastercard", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/master.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/master.gif" }, { "id": "amex", "name": "American Express", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/amex.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/amex.gif" }, { "id": "naranja", "name": "Naranja", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/naranja.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/naranja.gif" }, { "id": "nativa", "name": "Nativa Mastercard", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/nativa.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/nativa.gif" }, { "id": "tarshop", "name": "Tarjeta Shopping", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/tarshop.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/tarshop.gif" }, { "id": "cencosud", "name": "Cencosud", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/cencosud.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/cencosud.gif" }, { "id": "cabal", "name": "Cabal", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/cabal.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/cabal.gif" }, { "id": "argencard", "name": "Argencard", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/argencard.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/argencard.gif" }, { "id": "diners", "name": "Diners", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/diners.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/diners.gif" }, { "id": "pagofacil", "name": "Pago Fácil", "payment_type_id": "ticket", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/pagofacil.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/pagofacil.gif" }, { "id": "rapipago", "name": "Rapipago", "payment_type_id": "ticket", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/rapipago.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/rapipago.gif" }, { "id": "redlink", "name": "RedLink", "payment_type_id": "atm", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/redlink.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/redlink.gif" }, { "id": "bapropagos", "name": "Provincia Pagos", "payment_type_id": "ticket", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/bapropagos.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/bapropagos.gif" }, { "id": "account_money", "name": "Dinero en mi cuenta de MercadoPago", "payment_type_id": "account_money", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/account_money.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/account_money.gif" }, { "id": "cmr", "name": "CMR", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/cmr.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/cmr.gif" }, { "id": "cordial", "name": "Cordial", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/cordial.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/cordial.gif" }, { "id": "cordobesa", "name": "Cordobesa", "payment_type_id": "credit_card", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/cordobesa.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/cordobesa.gif" }, { "id": "cargavirtual", "name": "Red Carga Virtual", "payment_type_id": "ticket", "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/cargavirtual.gif", "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/cargavirtual.gif" }" Leer más.
/applications/$APPLICATION_ID	Devuelve datos sobre la applicación.	GET Go back X Devuelve detalles de la aplicación. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/applications/3022782903258037` Respuesta `"{ "id": 3022782903258037, "site_id": "MLA", "name": "TestJuli", "description": "prueba1Juli", "thumbnail": null, "owner_id": 206478736, "catalog_product_id": null, "item_id": null, "price": null, "currency_id": null, "need_authorization": true, "short_name": "test1", "url": "http://apps.mercadolibre.com.ar/test1", "callback_url": "https://www.julitest.com", "sandbox_mode": true, "is_public": true, "project_id": null, "active": true, "max_requests_per_hour": 18000, "scopes": [], "domains": [ ] }` Leer más.
/users/$USER_ID/brands	Este recurso recupera marcas asociadas a un user_id. El atributo official_store_id identifica una tienda.	GET Go back X Devuelve marcas por usuarios `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/12345678/brands` Respuesta "{ "cust_id": 12345678, "tags": [ "large_seller", "user_info_verified", "brand" ], "brands": [ { "tags": [ "girls", "female" ], "official_store_id": 16, "categories_ids": [ "MLA1430" ], "fantasy_name": "47 Street", "site_id": "MLA", "status": "active", "name": "47 Street", "pictures": [ { "id": 104, "name": "big_logo", "secure_url": null, "url": "http://static.mlstatic.com/org-img/apparel/images/47street/149254178-logo-g2.jpg", "size": "174x164" }, {}, {}, {}, {}, {} ], "relevance_position": 50 }, {}, {}, {}, {} ], "site_id": "MLA", "user_type": "brand" }" Leer más.
/users/$USER_ID/classifieds_promotion_packs	Recupera información de los paquetes de promoción para el usuario.	GET POST Go back X Devuelve paquetes en promoción por usuario. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/135146148/classifieds_promotion_packs` Respuesta "{ "id": 754985, "user_id": "135146148", "promotion_pack_id": "MPAB", "category_id": "MLU1743", "description": "Paquete 15 Básico", "package_type": "rotary", "status": "active", "date_created": "2013-05-23T15:34:48.498-04:00", "date_start": "2013-05-23T15:34:47.544-04:00", "date_expires": "2013-06-22T15:34:47.544-04:00", "date_stopped": null, "last_updated": "2013-05-23T15:35:48.211-04:00", "engagement_type": "none", "charge_id": 822129921, "remaining_listings": 15, "used_listings": 0, "listing_details": [ { "listing_type_id": "silver", "available_listings": 15, "used_listings": 0, "remaining_listings": 15 } ] }" Leer más. Go back X Puede asociarse un paquete existente a un usuario. La creación de paquetes se hace por medio de un asesor comercial. `curl-X POST -H 'Authorization: Bearer $ACCESS_TOKEN' "Content-type:application/json"-d '{ "categ_id": "MLA1459", "promotion_pack_id": "IPIN", "engagement_type": "none", "status": "active" }'http: //api.mercadolibre.com/users/{User_id}/classifieds_promotion_packs` Leer más.
/users/$USER_ID/classifieds_promotion_packs/$LISTING_TYPE&categoryId=$CATEGORY_ID	Obtener la disponibilidad para el usuario a la lista debajo de un determinado tipo de venta y de categoría.	GET Go back X Devuelve Listing Type habilitado por usuario y categoría. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/classifieds_promotion_packs/silver?categoryId=MLA1459` Respuesta `{ "has_available_listings": true }` Leer más.
/users/$USER_ID/available_listing_types?category_id=$CATEGORY_ID	Listing types disponibles por usuarios y categorías.	GET Go back X Obtener listing types disponibles `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/available_listing_types` Respuesta { "available": [ { "site_id": "MLA", "id": "gold_pro", "name": "Oro Premium Full", "remaining_listings": null, "mapping": "gold_pro" }, { "site_id": "MLA", "id": "gold_special", "name": "Oro Profesional", "remaining_listings": null, "mapping": "gold_special" } ], "exceptions_by_category": [ { "category_id": "MLA1743", "available": [ { "site_id": "MLA", "id": "gold_premium", "name": "Oro Premium", "remaining_listings": null }, { "site_id": "MLA", "id": "gold", "name": "Oro", "remaining_listings": null }, { "site_id": "MLA", "id": "silver", "name": "Plata", "remaining_listings": null } ] }, { "category_id": "MLA1540", "available": [ { "site_id": "MLA", "id": "gold_premium", "name": "Platino 365", "remaining_listings": null }, { "site_id": "MLA", "id": "gold", "name": "Platino 90", "remaining_listings": null }, { "site_id": "MLA", "id": "silver", "name": "Básico 365", "remaining_listings": null }, { "site_id": "MLA", "id": "bronze", "name": "Básico 90", "remaining_listings": null } ] }, { "category_id": "MLA1459", "available": [ { "site_id": "MLA", "id": "silver", "name": "Plata", "remaining_listings": 100000 } ] } ] } Leer más.
/users/$USER_ID/available_listing_type/$LISTING_TYPE_ID?category_id=$CATEGORY_ID	Devuelve el listing types disponible bajo un tipo de listado según una categoría dada.	GET Go back X Devuelve la categoría disponible. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/available_listing_type/gold_special?category_id=MLA6602` Respuesta `{ "available": false, "cause": "Your feedback does not allow you to use this listing type.", "code": "listing.feedback.not_allowed", "mapping": "gold_special" }` Leer más.
/users/$USER_ID/applications/$APPLICATION_ID	Permisos de aplicación.	DELETE Go back X Revoca los permisos de una aplicación `$ curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' -H “Content-Type:application/json” https://api.mercadolibre.com/users/{cust_Id}/applications/{app_id}` Leer más.
/myfeeds?app_id=$APPLICATION_ID	Histórico de notificaciones.	GET Go back X Devuelve el histórico de aplicaciones por app. `$ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/myfeeds?app_id={App_id}` Leer más.