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

Wish Products API

Products APIs

Wish Products API is one of 21 APIs that Wish publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Products. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, and rate-limit docs.

This API exposes 9 operations across 5 paths, and defines 38 schemas. It is described by OpenAPI 3.0.0, at version 3.0.65.

Requests are made against a single base URL, https://merchant.wish.com.

9 operations 5 paths 38 schemas 2 DELETE4 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
3.0.65
Base URL
https://merchant.wish.com/api/v3
Authentication
OpenID Connect, OAuth 2.0
Resource Areas
1

Authentication & Security 2

Wish Products API declares 2 security schemes for authenticating requests. It supports OpenID Connect (OpenID) discovered at https://merchant.wish.com/oidc/.well-known/openid-configuration. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 37 scopes. By default, every request must be authenticated.

Paths & Operations 9

Across 5 paths, the API surfaces 9 operations — 2 DELETE, 4 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Products 9

Products APIs

GET
/api/v3/products/requests
List product create or update requests
listProductUpdateRequests 6 params → 200400
PUT
/api/v3/products/{id}/calculated_shipping
Enable/disable Calculated Shipping for the product
enableDisableCalculatedShipping 1 param body → 200400
GET
/api/v3/products/requests/{id}
Get a product create or update request
getProductUpdateRequest 1 param → 200400
DELETE
/api/v3/products/requests/{id}
Delete a product create or update request
deleteProductUpdateRequest 1 param → 204400
POST
/api/v3/products
Create a product
createProduct body → 200400
GET
/api/v3/products
List products
listProductsSync 9 params → 200
PUT
/api/v3/products/{id}
Update a product
updateProduct 1 param body → 200400
GET
/api/v3/products/{id}
Get a product
getProduct 1 param → 200400
DELETE
/api/v3/products/{id}
Delete a product
deleteProduct 1 param → 204400

Schemas 38

The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are Product (37 properties), ShallowProduct (23 properties), EditableProductParams (19 properties), ProductVariation (14 properties). Each schema is shown below with its type and property counts.

AddProductVariation
object
Image
object
3 properties
Unit
string
The unit of measurement for the total content of a product. This will be used to display the price per unit, and is the unit of measurement that will be used f…
Price
object
2 properties 2 required
Option
object
2 properties 2 required
CreateImage
object
3 properties
APIError
object
2 properties 2 required
EnableDisableCalculatedShipping
object
RegionShippingDetail
object
5 properties 1 required
Video
object
1 property
ShallowProduct
object
23 properties
VariationAttribute
object
2 properties 1 required
EditableVariationParams
object
11 properties
AttributeResponse
object
2 properties 1 required
ProductUpdateAdvancedLogisticsShipping
object
UnitInput
string
The unit of measurement for the total content of a product. This will be used to display the price per unit, and is the unit of measurement that will be used f…
RegionShippingPrice
object
The shipping price for the region. Can be set to null to remove the current region shipping price.
2 properties 2 required
AdvancedLogisticsShipping
object
5 properties
Consignment
object
2 properties
Product
object
37 properties
ProductUpdateRequest
object
6 properties
EditableProductParams
object
19 properties
Money
object
2 properties 2 required
CreateProduct
object
ProductVariation
object
14 properties
UpdateDefaultShipping
object
WarningType
string
The warning type applicable to your product, if any, for compliance with [California Proposition 65](https://www.p65warnings.ca.gov/). For more information on…
CalculatedShipping
object
1 property
UpdateProductVariation
object
DefaultShipping
object
2 properties
UpdateProduct
object
GPSRManufacturer
object
3 properties
LogisticsInfo
object
12 properties
CountryShippingDetail
object
6 properties 2 required
WarehouseInventory
object
2 properties 2 required
ListShallowProductsResponse
array
The list of products without nested data.
Attribute
object
2 properties 1 required
WarehouseToShipping
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wish-products-api-openapi.yml Raw ↑

Other APIs Wish publishes across the network.

Wish Brands API
Wish Bulk Products API
Wish Currencies API
Wish EU Product Compliance API
Wish France EPR Compliance API
Wish Germany EPR Compliance API
Wish Merchant API
Wish OAuth API
Wish Orders API
Wish Payments API
Wish Penalties API
Wish ProductBoost API