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 Bulk Products API

Products endpoints which process requests asynchronously and triggers a running job

Wish Bulk 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 Bulk Products. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, and rate-limit docs.

This API exposes 4 operations across 4 paths, and defines 27 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.

4 operations 4 paths 27 schemas 2 GET2 POST

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 Bulk 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 4

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

Bulk Products 4

Products endpoints which process requests asynchronously and triggers a running job

POST
/api/v3/products/bulk_get
Get products
getProducts → 200400
GET
/api/v3/products/bulk_update/{id}
Get the update products job status
getUpdateProductsStatus 1 param → 200400
POST
/api/v3/products/bulk_update
Update products
updateProducts body → 200400
GET
/api/v3/products/bulk_get/{id}
Get the get products job status
getGetProductsStatus 1 param → 200400

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are EditableProductParams (19 properties), LogisticsInfo (12 properties), EditableVariationParams (11 properties), BulkJob (7 properties). Each schema is shown below with its type and property counts.

Price
object
2 properties 2 required
Option
object
2 properties 2 required
CreateImage
object
3 properties
APIError
object
2 properties 2 required
RegionShippingDetail
object
5 properties 1 required
Video
object
1 property
VariationAttribute
object
2 properties 1 required
EditableVariationParams
object
11 properties
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
BulkJob
object
A generic report status object used when a bulk endpoint wants to return the status of their downloadable file
7 properties
BulkUpdateProduct
object
EditableProductParams
object
19 properties
Money
object
2 properties 2 required
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…
UpdateProductVariation
object
DefaultShipping
object
2 properties
UpdateProduct
object
LogisticsInfo
object
12 properties
CountryShippingDetail
object
6 properties 2 required
WarehouseInventory
object
2 properties 2 required
Attribute
object
2 properties 1 required
WarehouseToShipping
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wish-bulk-products-api-openapi.yml Raw ↑

Other APIs Wish publishes across the network.

Wish Brands 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
Wish Products API