Wildberries Digital (wbd)

This method allows you to create a new offer.

Required fields

• title — Offer name
• description — Offer description
• tags — Offer tags
• section — Offer category
• catalog_path — Offer subcategory
• age_rating — Offer age rating
• price — Offer price

Add a cover

The cover for the offer is uploaded separately after the offer is created.
You need to use the Add or update offer cover method.

Add additional media files

1. Upload media files using the Upload media file for an offer method. The method returns a list of URI addresses of the uploaded media files.
2. Add the media file URIs to the gallery field.

Offer category and subcategory

Use the Get categories and their subcategories method to get the subcategory ID and correctly match it with the category.

Offer from the "Services" category

section — 8

Access to publish content in this category is granted through a request to technical support.

Offer with unique keys

Offers with unique keys belong to the following categories (section):

• Activation keys — 3
• Coupons and entertainment — 12
• Gift certificates — 13

Required data:

• Keys for the offer
• Key activation instructions

Uploading keys

The list of keys is passed in the keys parameter of your request when creating the offer.
You can add more keys later using the Add activation keys method.

Adding key activation instructions

The key activation instructions must be added to the meta field in JSON format using the following example.
To make the text more attractive and readable, use a line break \n.

Example:

{
    "meta":{
        "key_instruction": "Инструкция по активации\n1. Зайдите на сайт ...\n2.Вставьте ключ в поле ..."
    }
}

Offer with content

Offers with content belong to the following categories (section):

• Video content — 1
• Audio content — 2
• E-books — 4
• Audiobooks — 5
• Digital goods — 6

Required data:

• Content for the offer

Adding content

If you have not yet added content to your seller's personal account, you can do so following these instructions.

To add content, you need to pass a list of data in the content parameter using the example below.

Example:

"content": [
    {
        "category_id": 1,
        "content": 8942
    },
    {
        "category_id": 1,
        "content": 4211
    }
]

where:

• category_id — Content category ID
• content — Content ID

You can get this information using the Get a list of your content method.

The method allows you to add or update an offer's cover.
For a more attractive offer card, we recommend:

1. Add images with a 1:1 aspect ratio.
2. Minimum image size is 1200x1200 pixels.
3. A background that contrasts with white.

The method allows you to edit offer information.

Offer category and subcategory

Use the Get categories and their subcategories method to get the subcategory ID and correctly match it with the category.

The method allows you to get information about specific offer.

The method allows to get a list of your offers using filtering.

Description of filtering parameters

• search — Search offers by name. Specify part of or the full name of the offer to search.
• category — Filter offers by content category. The list of categories can be found in the table.
• status — Filter offers by status. Possible values:
  • 0 — Draft
  • 1 — Published
  • 2 — Suspended
• sort — Sort offers by creation or update date. Specify created to sort by creation date and updated to sort by update date.
• sort_dir — Sort direction. Specify asc for ascending sort or desc for descending sort.
• skip — Offset. Allows you to skip a specified number of offers in the result set.
  For example, if skip is 20, the selection will start from the 21 record.
• take — Number of offers that should be returned in the response.
  For example, if take is 10, the response will contain no more than 10 records.

The method allows you to change the offer's price and the discounted price.

If you don't want to set a discount, do not pass the discount_price parameter in the request, or set its value to 0.

The method allows you to update the status of your offer.

Possible values:

• 0 — Draft
• 1 — Published
• 2 — Suspended
• 3 — Deleted

The method allows you to get a tree (data structure) with categories and their subcategories.

Data structure hierarchy

Our structure has three levels of hierarchy:

1. Root node — the Catalog entity
2. External nodes are categories (section):
   • 1 — Video content
   • 2 — Audio content
   • 3 — Activation keys
   • 4 — E-books
   • 5 — Audiobooks
   • 6 — Digital goods
   • 8 — Services
   • 12 — Coupons and entertainment
   • 13 — Gift certificates
3. Tree leaves are subcategories (catalog_path):
   • 65 — Educational videos
   • 66 — Sports
   • 67 — Masterclass
   • 68 — Yoga
   • 69 — Meditations

The method allows you to upload a content cover.

Quick instructions on how to use:

1. Make sure your file meets the specified restrictions and recommendations.
2. Call this method.
3. When you upload the cover, you will get a list of URIs for the new content.
4. Use the Initialize new content method and pass the list of URIs to the meta field in JSON format using the following example.

Example:

{
    "meta": {
        "thumbnail": [
            "vol6/529/013cfs7f229183179aj53d2b3bbb839a/480.jpg",
            "vol6/529/013cfs7f229183179aj53d2b3bbb839a/1280.jpg",
            "vol6/529/013cfs7f229183179aj53d2b3bbb839a/1920.jpg"
        ]
    }
}

The method allows you to initialize (upload) new content information.

You can find the content types and their requirements in the Working with content section.

Preparing the file for subsequent upload:

• You need to split the file into parts (chunks) of no more than 2 MB.
• Pass the size (in bytes) of each part and its sequence number in the parts parameter.

Example:
A 5 MB file should be split into 3 parts — 2 MB, 2 MB, and 1 MB.

{
    "parts": [
        {
            "index": 1,
            "size": 2097152
        },
        {
            "index": 2,
            "size": 2097152
        },
        {
            "index": 3,
            "size": 1048576
        }
    ],
}

In the Upload content (file) method, you will need to upload 3 parts of the file, specifying their sequence number via X-Wbd-Part-Index.

Required fields in metadata (meta) for content upload

General fields:

• thumbnail
• rating

Audio content:

• author

Document:

• author
• pages

Quick instructions on how to use:

1. Prepare the metadata and information about your content.
2. Make sure your content meets the requirements (file format and size).
3. Call this method to initialize the new content.
4. In the response, you will get the content uuid, which is required for the subsequent file upload.
5. Use the Upload content file method to upload the file.

The method allows you to upload content (a file) in parts.

Quick instructions on how to use:

1. Split the file into parts of no more than 2 MB.
2. For each part of the file:
   • Make sure the X-Content-Type header matches your content type (e.g., video/mp4, audio/mpeg, application/pdf, etc.).
   • Set the X-Wbd-Part-Index header according to the index of the current part (starting from 1).
   • Specify the content uuid in the X-Wbd-Content-Uuid header, which you received when initializing new content.
   • Send the bytes (the file part) in the request body.
3. Repeat step 2 for all parts of the file until the upload is complete.

The method allows you to edit information about content.

The method allows you to get information about specific content.

The method allows to get a list of your content using filtering.

Description of filtering parameters

• search — Search content by name. Specify part of or the full name of the content to search.
• category — Filter content by category. The list of categories can be found in the table, column — catalog_id — Categories identification.
• status — Filter content by status. Possible values:
  • 0 — Created
  • 1 — Uploaded to server
  • 2 — Published
  • 3 — Error in processing or publication
  • 4 — Processing
  • 5 — Sent to server
• sort — Sort content by creation or update date. Specify created to sort by creation date and updated to sort by update date.
• sort_dir — Sort direction. Specify asc for ascending sort or desc for descending sort.
• skip — Offset. Allows you to skip a specified number of content in the result set.
  For example, if skip is 20, the selection will start from the 21 record.
• take — Number of content that should be returned in the response.
  For example, if take is 10, the response will contain no more than 10 records.

The method allows you to download content by URI.

Getting the content URI

1. Use one of the methods to get content information.
   • Get content information
   • Get a list of your content
2. In the content information, take the URI address from the uri or files field.

Downloading content in parts

You can download the file in parts using the Range header.

Example: Range: bytes=0-524287999

The response contains the Content-Range header with information about the downloaded file.

Example: Content-Range: bytes 0-524287999/1073741824

The method allows you to delete content by ID.

The method allows you to upload media files to the server.

After a successful upload, it returns a list of URIs that can be used to add additional media files to an offer.

This method helps you add additional media files when creating or updating an offer.

• Create new offer
• Edit offer

The method allows adding keys to an offer by ID.

The method allows deleting activation keys by their IDs.

The method allows you to get a list of redeemed keys using filtering.

Description of filtering parameters

• offer_id — Filter by offer ID. Allows selecting keys associated with a specific offer.
• skip — Offset. Specifies how many records to skip in the result set.
  For example, if skip is 20, the selection will start from the 21 record.
• take — Number of records to retrieve. Specifies how many keys should be returned in the response.
  For example, if take is 10, the response will contain no more than 10 records.
• date_from — Filter by purchase date starting from the specified date (included).
  Date format: RFC3339.
• date_to — Filter by purchase date up to the specified date (excluded).
  Date format: RFC3339.

The method allows you to get information about the number of keys for a specific offer.

The method allows you to get a list of the keys you have uploaded for a specific offer.