WB API Digest — May 2025

WB API Update Digest – May 2025

May 2025 was a productive month for the evolution of the Wildberries API. The development team introduced key improvements, clarified functionality, and enhanced the developer experience. Read on for a detailed breakdown of the major changes.

---

Improved Error Messages in Pricing and Discount Methods

Updated Error Texts

Error messages in API responses for pricing and discount methods have been revised. The new texts offer clearer and more detailed explanations of the causes, simplifying debugging and improving usability.

For example, a previous error message for exceeding item limits used to be:

{
"errorText": "Goods number limit exceeded"
}

Now it reads more informatively:

{
"errorText": "Upload limit exceeded: You can upload a maximum of 1000 items"
}

---

New Sandbox for DBS Orders

Test DBS Order Methods in a New Sandbox Environment

We’ve launched a new sandbox specifically for working with DBS orders. Developers can now test:

• Assembly tasks
• Metadata
• Warehouse and inventory management

A dedicated method has also been added for creating DBS assembly tasks in the test environment.

Enhancements to the "API Access" Tab

Easier and More Visual Token Management

This tab has seen major improvements. It now includes:

• Display of remaining days before a token expires
• Quick token duplication feature
• Updated onboarding for a smoother token management experience

New DBS Order Management Capabilities

Paid Delivery Information

Starting May 20, a new groupId field has been added to methods retrieving new and completed assembly tasks. This links tasks by warehouse and transaction, providing insights into paid delivery. A dedicated method to retrieve paid delivery info has also been introduced.

Pickup and Reservation Commission Data

Enhanced Commission Analytics

The response of the commission retrieval method now includes:

• kgvpPickup – Commission for the “Pickup” model
• kgvpBooking – Commission for the “Reservation” model

This allows sellers to better calculate profitability and manage pricing strategy.

Transition to a New File Retrieval Mechanism in Messages

More Secure File Handling

Wildberries is gradually moving away from direct file links in messages. Instead, files will now be accessed using a unique downloadID field present in message structures. This ID can be used with a separate method to download the file. Direct links will be phased out over time.

New Integration Guides and Use Cases

Detailed Instructions and Practical Examples

In May, a new guide on working with DBS orders was published. It includes a comprehensive explanation of API methods for DBS and EDBS models, method call sequences, and intuitive process flowcharts.

Also released were up-to-date integration use cases from TD BMM and “Mikh Hobby,” helping sellers adopt and leverage the API more efficiently.

Introduction of Separate Rate Limits for Product Cards

Smarter Rate Limit Management

As of early June, separate rate limits (10 requests per minute) are enforced for methods related to creating and editing product cards (/cards/upload, /cards/upload/add, /cards/update). It’s recommended to group as many product cards as possible into a single request to optimize API usage.

May’s WB API updates reflect the platform’s commitment to improving developer and seller experience through greater transparency and convenience. Stay tuned to our digests to keep up with all the key changes and innovations!