wildberries-api 
Wildberries API client
Installation
# Sync only mode
pip install wildberries-api[sync]
# Async only mode
pip install wildberries-api[async]
# All modes
pip install wildberries-api[all]
Instantiating
There are several ways to work with the API (synchronous and asynchronous). Both interfaces have the same signatures, the only difference is the need to use async/await keywords.
from wb_api.sync_api import SyncAPI # Sync mode
from wb_api.async_api import AsyncAPI # Async mode
from wb_api.const import BaseURL
def main() -> None:
api = SyncAPI.build(
token="...",
base_url=BaseURL, # (optional) may be used for test circuits
)
# Do things here...
async def main() -> None:
api = await AsyncAPI.build(
token="...",
base_url=BaseURL, # (optional) may be used for test circuits
)
# Do things here...
await api.close()
Where can I get token?
See official docs.
Common API
Check connection
# Sync mode
from wb_api.sync_api import SyncAPI
api = SyncAPI.build(...)
response = api.common.ping()
Docs: https://dev.wildberries.ru/openapi/api-information#tag/Proverka-podklyucheniya-k-WB-API
Feedback API
Check connection
# Sync mode
from wb_api.sync_api import SyncAPI
api = SyncAPI.build(...)
response = api.feedback.ping()
Docs: https://dev.wildberries.ru/openapi/api-information#tag/Proverka-podklyucheniya-k-WB-API
Check new questions and feedbacks existing
# Sync mode
from wb_api.sync_api import SyncAPI
api = SyncAPI.build(...)
response = api.feedback.check_new_feedbacks_questions()
Get count of unanswered questions
# Sync mode
from wb_api.sync_api import SyncAPI
api = SyncAPI.build(...)
response = api.feedback.get_question_count_unanswered()
Get count of questions
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import QuestionCountRequest
api = SyncAPI.build(...)
response = api.feedback.get_question_count()
# or
request = QuestionCountRequest(is_answered=False, ...)
response = api.feedback.get_question_count(request)
Get question list
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import QuestionListRequest
api = SyncAPI.build(...)
request = QuestionListRequest(is_answered=False, take=100, skip=0)
response = api.feedback.get_question_list(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Voprosy/paths/~1api~1v1~1questions/get
Mark question as read
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import QuestionMarkAsReadRequest
api = SyncAPI.build(...)
request = QuestionMarkAsReadRequest(id="question-id", was_viewed=True)
response = api.feedback.mark_question_as_read(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Voprosy/paths/~1api~1v1~1questions/patch
Reject question
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import QuestionRejectRequest
api = SyncAPI.build(...)
request = QuestionRejectRequest.create("question-id", "reject-reason")
response = api.feedback.reject_question(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Voprosy/paths/~1api~1v1~1questions/patch
Add question answer
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import QuestionAnswerAddRequest
api = SyncAPI.build(...)
request = QuestionAnswerAddRequest.create("question-id", "question-answer")
response = api.feedback.add_question_answer(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Voprosy/paths/~1api~1v1~1questions/patch
Update question answer
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import QuestionAnswerUpdateRequest
api = SyncAPI.build(...)
request = QuestionAnswerUpdateRequest.create("question-id", "question-answer")
response = api.feedback.update_question_answer(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Voprosy/paths/~1api~1v1~1questions/patch
Get question
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import QuestionGetRequest
api = SyncAPI.build(...)
request = QuestionGetRequest(id="question-id")
response = api.feedback.get_question(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Voprosy/paths/~1api~1v1~1question/get
Get count of unanswered feedbacks
# Sync mode
from wb_api.sync_api import SyncAPI
api = SyncAPI.build(...)
response = api.feedback.get_feedback_count_unanswered()
Get count of feedbacks
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackCountRequest
api = SyncAPI.build(...)
response = api.feedback.get_feedback_count()
# or
request = FeedbackCountRequest(is_answered=False)
response = api.feedback.get_feedback_count(request)
Get feedback list
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackListRequest
api = SyncAPI.build(...)
request = FeedbackListRequest(is_answered=False, take=100, skip=0)
response = api.feedback.get_feedback_list(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Otzyvy/paths/~1api~1v1~1feedbacks/get
Get feedback supplier valuations
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackSupplierValuationsRequest
api = SyncAPI.build(...)
response = api.feedback.get_feedback_supplier_valuations()
# or
request = FeedbackSupplierValuationsRequest(locale="zh")
response = api.feedback.get_feedback_supplier_valuations(request)
Report feedback text
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackTextReportRequest
api = SyncAPI.build(...)
request = FeedbackTextReportRequest(id="feedback-id", supplier_feedback_valuation=1024)
response = api.feedback.report_feedback_text(request)
Report feedback product
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackProductReportRequest
api = SyncAPI.build(...)
request = FeedbackProductReportRequest(id="feedback-id", supplier_product_valuation=1024)
response = api.feedback.report_feedback_product(request)
Add feedback answer
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackAnswerAddRequest
api = SyncAPI.build(...)
request = request = FeedbackAnswerAddRequest(id="feedback-id", text="feedback-answer")
response = api.feedback.add_feedback_answer(request)
Update feedback answer
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackAnswerUpdateRequest
api = SyncAPI.build(...)
request = FeedbackAnswerUpdateRequest(id="feedback-id", text="feedback-answer")
response = api.feedback.update_feedback_answer(request)
Return order by feedback id
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackOrderReturnRequest
api = SyncAPI.build(...)
request = FeedbackOrderReturnRequest(feedback_id="feedback-id")
response = api.feedback.return_feedback_order(request)
Get feedback
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackGetRequest
api = SyncAPI.build(...)
request = FeedbackGetRequest(id="feedback-id")
response = api.feedback.get_feedback(request)
Docs: https://dev.wildberries.ru/openapi/user-communication#tag/Otzyvy/paths/~1api~1v1~1feedback/get
Get archive feedback list
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.feedback.dataclass import FeedbackArchiveListRequest
api = SyncAPI.build(...)
request = FeedbackArchiveListRequest(take=100, skip=0)
response = api.feedback.get_feedback_archive_list(request)
Chat API
Get chat list
# Sync mode
from wb_api.sync_api import SyncAPI
api = SyncAPI.build(...)
response = api.chat.get_chat_list()
Get chat event list
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.chat.dataclass import ChatEventListRequest
request = ChatEventListRequest(next=...)
response = api.chat.get_chat_event_list()
# or
response = api.chat.get_chat_event_list(request)
Notes
- ChatEvent may contain expired
reply_sign
Send chat message
# Sync mode
import os
from wb_api.sync_api import SyncAPI
from wb_api.chat.dataclass import ChatMessageCreateRequest
from wb_api.base.dataclass import File
# text message sending
request = ChatMessageCreateRequest(reply_sign="...", message="...")
response = api.chat.create_chat_message(request)
# file message sending
request = ChatMessageCreateRequest(
reply_sign="...",
file=[
File(
name="image.png",
content=open("image.png", mode="rb"),
content_type="image/png",
content_length=os.path.getsize("image.png"),
),
],
)
response = api.chat.create_chat_message(request)
Notes
- Maximum size of a single file is 5 MB;
- Maximum size of all files is 30 MB;
- See the list of supported formats in the WB documentation.
Download file
# Sync mode
from wb_api.sync_api import SyncAPI
from wb_api.chat.dataclass import FileDownloadRequest
request = FileDownloadRequest(download_id="<uuid>")
file = api.chat.download_file(request)
Metadata
Release files for wildberries-api 2.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| wildberries_api-2.3.0.tar.gz | 137.5 kB | With provenance | Details for wildberries_api-2.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| wildberries_api-2.3.0-py3-none-any.whl | Python 3 | none | any | Details for wildberries_api-2.3.0-py3-none-any.whl |
Total release size: 175.3 kB
Release files / wildberries_api-2.3.0.tar.gz
| Download URL | wildberries_api-2.3.0.tar.gz |
|---|---|
| Size | 137.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ed9b89bba074b5c0392622bfe2a1a4730c96f374c6df15a5f00d51cad3e12bb
|
|
BLAKE2b-256 checksum How to use checksums |
a6da16f8f228cd05e88af1ae47fee573cb50dbb84fd9750d61920b2099ee2467
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 19, 2026.
Transparency logRelease files / wildberries_api-2.3.0-py3-none-any.whl
| Download URL | wildberries_api-2.3.0-py3-none-any.whl |
|---|---|
| Size | 37.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d710e73091d9940103ed8e197c17c67adfcd4e94eff574feb80aed4afe2b58d8
|
|
BLAKE2b-256 checksum How to use checksums |
7eedb64e85c787c5c88c58c2c8ec96cccdc6c0031e01b7fd9cf41f9430bdddad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 19, 2026.
Transparency logSecurity for wildberries-api 2.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for wildberries_api-2.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 19, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.