Ready to embark on your journey to become a Wallapop selling pro? Before we jump into the nitty-gritty of programming your app to publish items, let’s walk through the thrilling quest known as the "Publish Item Flow." Buckle up as we outline the essential steps to get your treasures listed for sale!
This guide is your trusty map, providing a conceptual overview of the steps needed to publish an item for sale on the Wallapop platform using the API. For those who crave a deeper dive into the technical waters of implementation, check out our Listing Guide.
The process of publishing items through the API can be likened to an adventurous journey. Here's your roadmap:
Before you can showcase your fabulous items, you must first identify the right category! Dive into Wallapop's category hierarchy and discover where your item fits best. This is your chance to distinguish between assignable and unassignable categories—an essential skill for every trader!
When you send a POST request to /items/categories, you’ll uncover Wallapop's treasure trove of categories in JSON format.
Imagine stumbling upon the Collectibles & Art category, which holds subcategories like "Antiques." You wouldn't want to assign your item to a broad category when a specific one exists! So, embrace the adventure—start with a wide net and zoom in on the perfect subcategory.
{
"id": 18000,
"name": "Collectibles & Art",
"assignable_to_item": false,
"subcategories": [
{
"id": 10071,
"parent_id": 18000,
"name": "Antiques",
"assignable_to_item": true,
"subcategories": []
}
// Other sub-categories...
]
}Embrace the journey of exploration—analyzing category hierarchies is your first quest before you can publish!
If you’ve got your sights set on a specific category, this adventure will be a breeze! For those with a mixed bag of items, consider grouping related categories together. This way, you can efficiently publish in bulk through the API, just like a seasoned treasure hunter!
Next, it’s time to decode the attributes accepted by the API. You might need to tweak your column values to ensure they match the required standards. Think of it as crafting the perfect spell—your item’s qualities need to shine!
Let’s say you’re selling a sleek car—the category assigned will be "car." This category has specific attributes, some mandatory for a successful listing. When you send a POST request, make sure to include key attributes like brand and model, each limited to 75 characters.
{
"attributes": [
{ "type": "text", "id": "brand", "is_mandatory": true, "max_length": 75 },
{ "type": "text", "id": "model", "is_mandatory": true, "max_length": 75 }
// other attributes...
]
}Keep an eye on those character limits as you craft your listings—you want them to sparkle!
It’s time to align your source data with the attributes prized by the API. After you’ve determined your item’s category and attributes, make sure to map your data columns accurately before your epic publishing adventure begins!
Double-check that your treasures follow the attribute constraints and that everything is formatted correctly before sending it off to the API.
Currently, Wallapop does not provide automated mapping, so it's up to you to map your source data. However, we provide powerful tools to keep your inventory synced!
We highly recommend mapping your internal SKUs or IDs to our external_id attribute (available for all categories) or using license_plate for cars. This creates a magical link between your system and ours, ensuring you can easily identify your items later. Always validate your data before launching it into the API!
Now, the moment of truth! To finalize your item publication, send a POST request to /items that includes a category_leaf_id (i.e., assignable category), attributes of your item, and key information like title, description, price, and images.
- Productionhttps://connect.wallapop.com/items
curl -i -X POST \
https://connect.wallapop.com/items \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"item": {
"category_leaf_id": "9931",
"title": "Title example",
"description": "A renowned line of performance and lifestyle sneakers that offer superior comfort, support, and style both on and off the court.",
"price": {
"cash_amount": 75.5,
"currency": "EUR"
},
"attributes": {
"external_id": "407947058",
"brand": "Abc Design",
"size": 34,
"condition": "new",
"color": "yellow"
},
"hashtags": [
"awesome",
"original"
],
"delivery": {
"allowed_by_user": true,
"max_weight_kg": 10,
"free_shipping": false
}
},
"main_image": {
"url": "http://cdn.portal.com/image129.jpg"
},
"stock": {
"units": 0
}
}'In the Wallapop PRO ecosystem, your subscription plan dictates the volume of products you can showcase simultaneously. This is known as your Subscription Limit.
It is essential to distinguish between the two states an item can hold within your inventory:
- Active Items: These are fully published and visible to potential buyers. Each active item consumes one slot in your subscription quota.
- Inactive Items: If you attempt to publish an item while your quota is full, the system saves it as "Inactive". These items are safely stored in your catalog but are hidden from the marketplace.
To optimize your sales strategy, you may need to perform Stock Rotation. If your quota is full but you wish to promote high-priority items currently sitting in your "Inactive" list, you must first deactivate (hide) lower-priority items to free up space.
But the adventure doesn’t stop here. We recommend reviewing our Listing guide and Items API to learn how to manage your inventory. After that, you'll be ready to delve into what happens after a buyer snags an item by exploring the How Transactions Work.