Catalog listing

Contents

→List from an existing post
→Sales conditions sync
→List directly to catalog
→Automatic creation of catalog publications



List from an existing post (optin)

Once you validate that your existing publication is eligible for catalog and you get the active catalog_product_id , from the product search resource , which corresponds exactly to what you are publishing, You must create the catalog post with a POST to / items / catalog_listings .


Variations

In the domains where there is currently a catalog, their publications do not allow variations because they are already associated with a specific product. So if your original post had variations, you will have a catalog post for each one.
The relevant information of your variations, such as the color of the item, will not be lost but will be reflected in the attributes of the catalog product. In the future, there may be domains where the product never fully specifies what is being sold, for example in clothing to size, and it is possible that variations are allowed. We will notify you when that happens.

If your existing item contains variations, you must make a POST for each one of them by sending the variation_id field in the body of the POST.


Example on an item with variations:

curl -X POST https://api.mercadolibre.com/items/catalog_listings?access_token=$ACCESS_TOKEN
{
  "item_id":"MLA1234",
  "variation_id": 4321,
  "catalog_product_id":"MLA9876"
}

Example on an item without variations:

curl -X POST https://api.mercadolibre.com/items/catalog_listings?access_token=$ACCESS_TOKEN
{
  "item_id":"MLA1234",
  "catalog_product_id":"MLA9876" 
}

Short example of response to the creation of an item:

Response:

{
    "id": "MLA1234",
    "site_id": "MLA",
    "title": "Samsung Galaxy J7 Prime 16 Gb Negro",
    "warranty": null,
    "catalog_product_id": "MLA9876",
    "domain_id": "MLA-CELLPHONES",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2019-08-02T11:33:31.270Z",
    "last_updated": "2019-08-02T11:33:31.270Z",
    "total_listing_fee": null,
    "health": null,
    "catalog_listing": true,
    "item_relations": [
        {
            "id": "MLA123456789",
            "variation_id": null,
            "stock_relation": 1
        }
    ]
}

Also, remember:

  • If the item is sent without variations when it does, the response will be a 400 error.
  • The catalog_product_id field is required in the POST for items with or without variations.

Sincronización de condiciones de venta

Important:
This functionality will be effective as of October 8, 2020.

The synchronization of the conditions of sale (such as price, delivery method, stock, guarantee, SKU and PIs) of the associated publications will be automatic for the items with items_relations and with the following rules:
- The seller will not be able to remove the sync (opt-out).
- The new listings they will be in sync from the start.
- The associated existing listings will be synchronized as soon as the seller modifies any of the conditions of sale of the original publication.

Notes:
- The synchronization will be after the original is modified, that is, if the seller first modifies the catalog publication, we will automatically update the general list publication with that of reference, and vice versa.
- The changes will be notified through the item feed.

Sales conditions sync

To carry out a direct publication in the catalog it is necessary, first of all, to obtain the catalog_product_id that corresponds exactly to the product to be published, consulting the product search resource you get a product suggestion based on certain search parameters.

Important:
The content of the catalog publication is provided by Mercado Libre. Therefore, the seller is responsible for confirming that the product to be associated matches the specific characteristics displayed on the platform.

In the event that there is a difference between what the user buys and the associated product, it is possible that claims and/or cancellations are generated that will negatively impact their reputation and as a result of this, the inability to publish in the Catalog, eventually leading to suspension. from account.

In addition to cataloging an original post, you can also create catalog items without the need for a marketplace item to link. Keep in mind that to create the catalog item you must consider the same requirements set forth in Publish item in catalog.

Keep in mind that at the time of POST it is necessary to send the following values for the catalog publication to be created.

"catalog_product_id": this value must be confirmed with the search/product resource.
"catalog_listing": true: it is necessary to send the value in true to generate the catalog item.


Request:

curl -X POST https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Example:

curl -X POST -H "Content-Type: application/json" -d
'{
    "site_id": "MLA",
    "title": "Item de test no ofertar",
    "category_id": "MLA1055",
    "price": 10000000,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "pictures": [],
    "attributes": [
        {
            "id": "CARRIER",
            "name": "Compañía telefónica",
            "value_id": "298335",
            "value_name": "Liberado",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "catalog_product_id": "MLA6005934",
    "catalog_listing": true
}'
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Response:

{
    "id": "MLA811894603",
    "site_id": "MLA",
    "title": "Apple iPhone iPhone 3g 8 Gb Negro 128 Mb Ram",
    "subtitle": null,
    "seller_id": 464161506,
    "category_id": "MLA1055",
    "official_store_id": null,
    "price": 10000000,
    "base_price": 10000000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "start_time": "2019-08-29T14:49:42.945Z",
    "historical_start_time": "2019-08-29T14:49:42.945Z",
    "stop_time": "2039-08-24T04:00:00.000Z",
    "end_time": "2039-08-24T04:00:00.000Z",
    "expiration_time": "2019-11-17T14:49:42.987Z",
    "condition": "new",
    "permalink": "http://articulo.mercadolibre.com.ar/MLA-811894603-apple-iphone-iphone-3g-8-gb-negro-128-mb-ram-_JM",
    "pictures": [
        {
            "id": "675782-MLA31138875214_062019",
            "url": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
            "size": "249x500",
            "max_size": "598x1200",
            "quality": ""
        },
        {
            "id": "915001-MLA31138546867_062019",
            "url": "http://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
            "size": "250x500",
            "max_size": "600x1200",
            "quality": ""
        },
        {
            "id": "881441-MLA31138332972_062019",
            "url": "http://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
            "size": "243x500",
            "max_size": "585x1200",
            "quality": ""
        },
        {
            "id": "804666-MLA31139286536_062019",
            "url": "http://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
            "size": "405x500",
            "max_size": "836x1030",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA811894603-2265773390"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1061221617,
        "comment": "",
        "address_line": "Test Address 123",
        "zip_code": "1414",
        "city": {
            "id": "",
            "name": "Palermo"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": 38.11569,
        "longitude": 13.3614868,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlBBTDI1MTVa",
                "name": "Palermo"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": 38.11569,
        "longitude": 13.3614868
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "CARRIER",
            "name": "Compañía telefónica",
            "value_id": "298335",
            "value_name": "Liberado",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "9344",
            "value_name": "Apple",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "LINE",
            "name": "Línea",
            "value_id": "58993",
            "value_name": "iPhone",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": "14605",
            "value_name": "iPhone 3G",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "IS_DUAL_SIM",
            "name": "Es Dual SIM",
            "value_id": "242084",
            "value_name": "No",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "COLOR",
            "name": "Color",
            "value_id": "52049",
            "value_name": "Negro",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "INTERNAL_MEMORY",
            "name": "Memoria interna",
            "value_id": "59566",
            "value_name": "8 GB",
            "value_struct": {
                "number": 8,
                "unit": "GB"
            },
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "RAM",
            "name": "Memoria RAM",
            "value_id": "366239",
            "value_name": "128 MB",
            "value_struct": {
                "number": 128,
                "unit": "MB"
            },
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "MAIN_COLOR",
            "name": "Color principal",
            "value_id": "2450295",
            "value_name": "Negro",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "OPERATING_SYSTEM_NAME",
            "name": "Nombre del sistema operativo",
            "value_id": "7404961",
            "value_name": "iOS",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "WITH_IMEI",
            "name": "Con IMEI",
            "value_id": "242085",
            "value_name": "Sí",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "immediate_payment",
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": "MLA6005934",
    "domain_id": "MLA-CELLPHONES",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2019-08-29T14:49:43.099Z",
    "last_updated": "2019-08-29T14:49:43.099Z",
    "total_listing_fee": null,
    "health": null,
    "catalog_listing": true,
    "item_relations": []
}

Creación automática de publicaciones de catálogo

Important:
Actualmente, desde Mercado Libre no estamos creando publicaciones forzadas a catálogo pero recuerda que es muy importante estar suscrito al feed de ítems (notificaciones).

These catalog posts will be created with status paused and marked with the catalog_boost tag. Sellers will have 7 days to confirm that they sell exactly the products we associate them with. After that date, we will activate the publications automatically and they will lose the tag with which they were recognized. To find out the product to which your catalog item belongs, you can check the /products/{product_id} resource.

If your tool does not allow the seller to confirm that they sell exactly the products to which we associate their publications, you should recommend that they access the list of publications in their Mercado Libre account until you adapt your tool.

Next, you can see what the JSON of a catalog item looks like.


Example of tagged catalog item:

curl -X GET https://api.mercadolibre.com/items/MLA123456789

Response:

{
   "id":"MLA123456789",
   "site_id":"MLA",
   "title":"Samsung Galaxy A10 32 Gb Negro 2 Gb Ram",
   "subtitle":null,
   "seller_id":12312345,
   "category_id":"MLA1055",
   "official_store_id":null,
   "price":14498.49,
   "base_price":14498.49,
   "original_price":null,
   "currency_id":"ARS",
   "initial_quantity":1,
   "available_quantity":1,
   "sold_quantity":0,
   "sale_terms":[

   ],
   "buying_mode":"buy_it_now",
   "listing_type_id":"gold_special",
   "start_time":"2020-02-25T13:30:06.000Z",
   "stop_time":"2040-02-20T04:00:00.000Z",
   "condition":"new",
   "permalink":"https://articulo.mercadolibre.com.ar/MLA-840863454-samsung-galaxy-a10-32-gb-negro-2-gb-ram-_JM",
   "thumbnail":"http://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "secure_thumbnail":"https://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "pictures":[

   ],
   "video_id":"63vjmsBa3nw",
   "descriptions":[

   ],
   "accepts_mercadopago":true,
   "non_mercado_pago_payment_methods":[

   ],
   "shipping":{

   },
   "international_delivery_mode":"none",
   "seller_address":{

   },
   "seller_contact":null,
   "location":{

   },
   "geolocation":{

   },
   "coverage_areas":[

   ],
   "attributes":[

   ],
   "warnings":[

   ],
   "listing_source":"",
   "variations":[

   ],
   "status":"active",
   "sub_status":[

   ],
   "tags":[
      "brand_verified",
      "extended_warranty_eligible",
      "catalog_boost",
      "good_quality_picture",
      "good_quality_thumbnail",
      "immediate_payment",
      "cart_eligible"
   ],
   "warranty":"Garantía del vendedor: 6 meses",
   "catalog_product_id":"MLA14648964",
   "domain_id":"MLA-CELLPHONES",
   "parent_item_id":null,
   "differential_pricing":null,
   "deal_ids":[

   ],
   "automatic_relist":false,
   "date_created":"2020-02-25T13:30:06.000Z",
   "last_updated":"2020-02-28T16:28:14.000Z",
   "health":0.9,
   "catalog_listing":false
}
Note:
You can search by seller to identify the items that are marked with the tag using the following resource.

Example:

curl -X GET https://api.mercadolibre.com/users/1234567/items/search?status=paused&tags=catalog_boost&access_token=$ACCESS_TOKEN

Next: Catalog required listings.

or register to recieve the latest news about our API