Pasos Rápidos para Publicar un Inmueble de Prueba

Antes de iniciar, te dejamos la Guía para inmuebles

1. Crea un usuario de prueba: experimenta sin costo

Para familiarizarte con el proceso de publicación de inmuebles y probar la API sin incurrir en costos reales, te recomendamos crear un usuario de prueba.

• Utiliza nuestra API de Usuarios de Prueba : para generar un usuario con credenciales falsas que podrás usar para realizar pruebas en un entorno seguro y controlado.

2.Configura tu usuario de prueba como inmobiliaria

Una vez que hayas creado tu usuario de prueba, puedes configurarlo como una cuenta de inmobiliaria. Esto te permitirá probar las funcionalidades específicas que Mercadolibre ofrece a las inmobiliarias.

3.Contrata un paquete de publicaciones (promotion pack)

Cuando recibas la confirmación de que activamos tu usuario desde el canal de soporte, tienes que contratar un paquete de publicaciones para que puedas publicar inmuebles.

4. Obtener access token del usuario de test

Prepara tus credenciales, estas tienen que ser las mismas que utilizaste en los requisitos previos para obtener un access token y crear un usuario de test. Asegúrate de tener a mano:

• Tu Client ID.
• Tu Client Secret.
• La Redirect URI que definiste al crear tu aplicación.

Llamada:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/me

Si el proceso se completó correctamente, ya puedes continuar con los siguientes pasos utilizando el access token generado.

5.Publica tu inmueble

Si llegaste hasta este punto, ya estás listo para publicar un inmueble con tu usuario de prueba. Para ello, debes ejecutar una llamada POST a la API de publicación de inmuebles, incluyendo toda la información que has reunido en los pasos anteriores (token de acceso, categoría, atributos, ubicación, etc.).

Llamada:

curl --location 'https://api.mercadolibre.com/items' \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "title": "Propiedad de Test por favor no contactar",
    "listing_type_id": "silver",
    "category_id": "MLC157520",
    "currency_id": "CLP",
    "price": 100000000,
    "available_quantity": 1,
    "attributes": [
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null, 
            "value_name": "4300 m²",
            "value_struct": {
                "number": 4300,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "4300 m²",
                    "struct": {
                        "number": 4300,
                        "unit": "m²"
                    },
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number_unit"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Estacionamientos",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null,
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "value_type": "number"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie útil",
            "value_id": null,
            "value_name": "390 m²",
            "value_struct": {
                "number": 390,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "390 m²",
                    "struct": {
                        "number": 390,
                        "unit": "m²"
                    },
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number_unit"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null,
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "5",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "5",
                    "struct": null,
                    "source": 6596781661210240
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica",
            "source": 6596781661210240,
            "value_type": "number"
        }

    ],
    "condition": "used",
    "location": {
        "address_line": "H-20, La Estrella, O'\''Higgins, Chile",
        "zip_code": "",
        "neighborhood": {
            "id": "",
            "name": ""
        },
        "city": {
            "id": "TUxDQ0xBWmE0Y2Zm",
            "name": "La Estrella"
        },
        "state": {
            "id": "TUxDUE9IUzFjODg",
            "name": "Libertador B. O'\''Higgins"
        },
        "country": {
            "id": "CL",
            "name": "Chile"
        },
        "latitude": -34.2065985,
        "longitude": -71.6742634
    }
    
}'

Parámetros de publicación de inmuebles

6.Verificar el estado de la publicación

Una vez que hayas publicado el inmueble, obtendrás un id en la respuesta de la API. Utiliza este id para verificar el estado de la publicación mediante una petición GET:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID

Parámetros

Puedes conocer más acerca de publicar y consultar inmuebles en la sección de Publica inmuebles

7. Soporte

En caso de requerir ayuda con algún punto en específico que no pudiste solucionar mediante la documentación, puedes contactar a soporte aquí, ingresando con tu cuenta.

¿A dónde vamos?

Si deseas profundizar más en los diversos aspectos de la publicación de inmuebles en Mercado Libre y optimizar el uso de nuestra API, te recomendamos explorar las siguientes lecturas y recursos:

• Categorías y Atributos de publicación.
• Localizar Inmuebles.
• Gestiona paquetes inmuebles.
• Publica inmuebles.
• Desarrollos inmobiliarios.
• Estadísticas de publicación.