Skip to content
/
Publishing Items
Last updated

Publishing Items

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!

Concepts in Focus

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.

High-Level Overview

The process of publishing items through the API can be likened to an adventurous journey. Here's your roadmap:

Determine Category
Check Attributes & Constraints
Map Source Data
Publish Item

Flow Process

1) Determine Your Item's Category

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!

Pro Tip: Organize Like a Pro!

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!

2) Uncover Category Attributes

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!

3) Mapping Your Source Data

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.

Manual Mapping Alert!

Currently, we (Wallapop) do not provide automated mapping, so it's up to you to map your source data. We're always ready to offer guidance, so don’t hesitate to seek help. And remember—validate your data before launching it into the API!

4) Publish Your Item

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.

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
    }
  }'

What's Next on Your Journey?

But the adventure doesn’t stop here. We recommend reviewing our 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.

Previous page
Next page