How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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 Item. 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.2.0, 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.2.0
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.

Category
object
5 properties
ItemDetailResponse
object
14 properties 6 required
CategoriesResponse
object
1 property
CategoryAttributeNumericValueResponse
object
An attribute that accepts numerical values.
6 properties 4 required
Expired
object
1 property 1 required
Metadata
object
1 property
RegexValidation
object
The regex validation applied to the value.
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
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.
Error
object
Additional detailed information regarding the error.
2 properties 2 required
UserItemsResponse
object
2 properties 2 required
AddItemImageRequest
object
2 properties 2 required
PaginationMetadata
object
1 property
MainImage
object
1 property 1 required
DeliveryAttributes
object
3 properties 1 required
ItemHashTags
array
List of hashtags.
CreateItemRequest
object
3 properties 2 required
Item
object
7 properties 4 required
MandatoryByDate
string
The expected date after which the attribute will be mandatory.
ImageURLs
object
3 properties 3 required
Image
object
2 properties 2 required
Attributes
object
Attributes that only apply for some categories. You can retrieve the expected attributes/values by category using [this operation](category/getCategoryAttribut…
GetMyItemsLimitsResponse
object
1 property 1 required
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
UpdateItemRequest
object
3 properties 1 required
ItemPrice
object
2 properties 2 required
CategoryAttributesResponse
object
1 property
Inactive
object
1 property 1 required
CategoryAttributeTextValueResponse
object
An attribute that accepts text input (i.e., a string of characters).
6 properties 4 required
ItemInUserItemsResponse
object
7 properties 4 required
Reserved
object
1 property 1 required
Sold
object
1 property 1 required
ItemLimitResponse
object
4 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
Where this information came from

This is an independent, third-party profile of Wallapop Items API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.