Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wallapop Items API

An item refers to a listing created by a user on the Wallapop marketplace, indicating their intent to sell. These items can include a diverse range of products.

Wallapop Items API is one of 6 APIs that Wallapop publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Items. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 16 operations across 13 paths, and defines 33 schemas. It is described by OpenAPI 3.0.1, at version 0.0.1.

Requests are made against a single base URL, https://connect.wallapop.com.

16 operations 13 paths 33 schemas 2 DELETE6 GET2 POST6 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
0.0.1
Base URL
https://connect.wallapop.com
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Wallapop Items API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oAuthWithPKCE) using the authorizationCode flow. By default, every request must be authenticated.

  • oAuthWithPKCE — The Items Connect API uses OAuth 2.0 Authorization Code flow with a Proof Key for Code Exchange.

Paths & Operations 16

Across 13 paths, the API surfaces 16 operations — 2 DELETE, 6 GET, 2 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

Items 16

An item refers to a listing created by a user on the Wallapop marketplace, indicating their intent to sell. These items can include a diverse range of products.

POST
/items
Create and publish an item
createItem 1 param body → 201400
GET
/items
List items for sale
userItems 1 param → 200400401
GET
/items/{itemId}
Retrieve item details
getItem 1 param → 200400403404
PUT
/items/{itemId}
Update an item
updateItem 2 params body → 204400403404409
DELETE
/items/{itemId}
Delete an item
deleteItem 1 param → 204400403404
POST
/items/{itemId}/images
Add a image to an item
addItemImage 1 param body → 201400403409
DELETE
/items/{itemId}/images/{imageId}
Delete an image from an item
deleteItemImage 2 params → 204400403404409
PUT
/items/{id}/sold
Mark an item as sold
markItemAsSold 1 param → 204403404
PUT
/items/{id}/activate
Publish an inactive item
activateItem 1 param → 204403404
PUT
/items/{id}/inactivate
Deactivate a published item
inactivateItem 1 param → 204403404
PUT
/items/{id}/reserve
Reserve an item
reserveItem 1 param → 204400403404
PUT
/items/{id}/unreserve
Cancel an item reservation
unReserveItem 1 param → 204400403404
GET
/items/categories
Retrieve all categories
1 param → 200
GET
/items/categories/{id}/attributes
Retrieve a category's attributes
getCategoryAttributes 2 params → 200404
GET
/items/limits
Retrieve the authenticated user's listing limits
getMyItemsLimits → 200401
GET
/items/inactive
List inactive items
userInactiveItems 1 param → 200400401

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are ItemDetailResponse (14 properties), ItemInUserItemsResponse (7 properties), Item (7 properties), CategoryAttributeNumericValueResponse (6 properties). Each schema is shown below with its type and property counts.

AddItemImageRequest
object
2 properties 2 required
Stock
object
The quantity of the item in the seller's inventory. This feature is only available to Wallapop Pro users. See [Add stock to your items](https://ayuda.wallapop.…
1 property 1 required
Attributes
object
Attributes that only apply for some categories. You can retrieve the expected attributes/values by category using [this operation](category/getCategoryAttribut…
ImageURLs
object
3 properties 3 required
ExternalImageURL
string
Provide a direct link to the image without redirections. The HTTP response code should be 2xx (e.g., 200). Only JPG or JPEG files up to 10 MB are allowed.
GetMyItemsLimitsResponse
object
1 property 1 required
Image
object
2 properties 2 required
Expired
object
1 property 1 required
ItemLimitResponse
object
4 properties 2 required
ItemPrice
object
2 properties 2 required
ItemHashTags
array
List of hashtags.
Item
object
7 properties 4 required
ItemDetailResponse
object
14 properties 6 required
CategoryAttributesResponse
object
1 property
CategoryAttributeTextValueResponse
object
An attribute that accepts text input (i.e., a string of characters).
6 properties 4 required
Metadata
object
1 property
CategoryAttributeDiscreteValuesResponse
object
An attribute that allows selection from a predefined set of options, similar to choosing a value from an enumerated list.
5 properties 4 required
RegexValidation
object
The regex validation applied to the value.
2 properties 2 required
Sold
object
1 property 1 required
UserItemsResponse
object
2 properties 2 required
CategoryAttributeNumericValueResponse
object
An attribute that accepts numerical values.
6 properties 4 required
Inactive
object
1 property 1 required
MainImage
object
1 property 1 required
Reserved
object
1 property 1 required
PaginationMetadata
object
1 property
Category
object
5 properties
CreateItemRequest
object
3 properties 2 required
UpdateItemRequest
object
3 properties 1 required
MandatoryByDate
string
The expected date after which the attribute will be mandatory.
ItemInUserItemsResponse
object
7 properties 4 required
CategoriesResponse
object
1 property
DeliveryAttributes
object
3 properties 1 required
Error
object
Additional detailed information regarding the error.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wallapop-items-api-openapi.yml Raw ↑

Other APIs Wallapop publishes across the network.

Wallapop Categories API
Wallapop Delivery API
Wallapop Disputes API
Wallapop Transactions API
Wallapop Webhooks API