{"openapi":"3.1.0","info":{"title":"Wildberries Content (BYOK) API","version":"0.1.0","description":"Wildberries Content (BYOK) lets an AI assistant read your own Wildberries Content data through the Wildberries Content API with a key you supply (Wildberries API token with the Content category (read-only is enough)). Read-only: 12 tools (list_parent_categories, list_subjects, get_subject_characteristics, list_colors, list_countries, list_genders, list_seasons, list_vat_rates, list_hs_codes,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-wildberries-content.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-wildberries-content/docs"},"termsOfService":"https://connectorbay.com/byok-wildberries-content/terms"},"servers":[{"url":"https://byok-wildberries-content.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-wildberries-content/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_parent_categories":{"post":{"operationId":"list_parent_categories","summary":"List the top-level Wildberries product categories (id, name and whether visible). Use for \"What are the parent categorie","description":"List the top-level Wildberries product categories (id, name and whether visible). Use for \"What are the parent categories on Wildberries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"title":"list_parent_categoriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_subjects":{"post":{"operationId":"list_subjects","summary":"List product subjects (item types) with their parent category; search by name and page with limit and offset. Use for \"W","description":"List product subjects (item types) with their parent category; search by name and page with limit and offset. Use for \"Which Wildberries subject ids match t-shirts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"},"name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Substring of the subject name to search for.","title":"Name"},"parent_id":{"anyOf":[{"maximum":100000000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only subjects of this parent category id.","title":"Parent Id"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":30,"description":"Results per page (1 to 1000).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"}},"title":"list_subjectsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_subject_characteristics":{"post":{"operationId":"get_subject_characteristics","summary":"List the characteristics a product card of one subject can or must have, with type, unit, maximum count and whether requ","description":"List the characteristics a product card of one subject can or must have, with type, unit, maximum count and whether required. Use for \"Which characteristics does a T-shirt card need on Wildberries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subject_id":{"description":"Subject id from list_subjects.","maximum":100000000,"minimum":1,"title":"Subject Id","type":"integer"},"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"required":["subject_id"],"title":"get_subject_characteristicsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_colors":{"post":{"operationId":"list_colors","summary":"List the colour values Wildberries accepts, with their parent colour. Use for \"Which colours can I use on Wildberries ca","description":"List the colour values Wildberries accepts, with their parent colour. Use for \"Which colours can I use on Wildberries cards\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"title":"list_colorsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_countries":{"post":{"operationId":"list_countries","summary":"List the countries of origin Wildberries accepts, with short and full names. Use for \"Which countries of origin does Wil","description":"List the countries of origin Wildberries accepts, with short and full names. Use for \"Which countries of origin does Wildberries accept\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"title":"list_countriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_genders":{"post":{"operationId":"list_genders","summary":"List the gender (kind) values Wildberries accepts on product cards. Use for \"Which gender values does Wildberries accept","description":"List the gender (kind) values Wildberries accepts on product cards. Use for \"Which gender values does Wildberries accept\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"title":"list_gendersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_seasons":{"post":{"operationId":"list_seasons","summary":"List the season values Wildberries accepts on product cards. Use for \"Which season values does Wildberries accept\".","description":"List the season values Wildberries accepts on product cards. Use for \"Which season values does Wildberries accept\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"title":"list_seasonsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_vat_rates":{"post":{"operationId":"list_vat_rates","summary":"List the VAT rate values Wildberries accepts on product cards. Use for \"Which VAT rates can I set on Wildberries\".","description":"List the VAT rate values Wildberries accepts on product cards. Use for \"Which VAT rates can I set on Wildberries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"title":"list_vat_ratesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_hs_codes":{"post":{"operationId":"list_hs_codes","summary":"List customs (HS/TNVED) codes for one subject, optionally filtered by a code prefix, with the marking flag. Use for \"Whi","description":"List customs (HS/TNVED) codes for one subject, optionally filtered by a code prefix, with the marking flag. Use for \"Which HS codes apply to Wildberries subject 105\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subject_id":{"description":"Subject id from list_subjects.","maximum":100000000,"minimum":1,"title":"Subject Id","type":"integer"},"search":{"anyOf":[{"maximum":9999999999,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"HS code to filter by.","title":"Search"},"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"}},"required":["subject_id"],"title":"list_hs_codesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_brands":{"post":{"operationId":"list_brands","summary":"List brands registered for a subject, with logo URL; page with the next cursor. Use for \"Which brands exist for Wildberr","description":"List brands registered for a subject, with logo URL; page with the next cursor. Use for \"Which brands exist for Wildberries subject 105\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"subject_id":{"description":"Subject id from list_subjects.","maximum":100000000,"minimum":1,"title":"Subject Id","type":"integer"},"next":{"anyOf":[{"maximum":2000000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's next field.","title":"Next"}},"required":["subject_id"],"title":"list_brandsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_card_limits":{"post":{"operationId":"get_card_limits","summary":"Show how many product cards the seller account may create for free and as paid extra. Use for \"How many product cards ca","description":"Show how many product cards the seller account may create for free and as paid extra. Use for \"How many product cards can I still create on Wildberries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_card_limitsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_product_cards":{"post":{"operationId":"list_product_cards","summary":"List your product cards (up to 100 per page) with article numbers, brand, title, size and dimensions; page by passing th","description":"List your product cards (up to 100 per page) with article numbers, brand, title, size and dimensions; page by passing the cursor values of the previous answer. Use for \"Which product cards do I have on Wildberries for brand Acme\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"locale":{"anyOf":[{"enum":["ru","en","zh"],"type":"string"},{"type":"null"}],"default":null,"description":"Language of names in the answer: ru, en or zh.","title":"Locale"},"text_search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Search text matched against vendor code, title or nmID.","title":"Text Search"},"ascending":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to sort by update time ascending, false for newest first.","title":"Ascending"},"cursor_updated_at":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"cursor.updatedAt of the previous answer (leave empty for the first page).","title":"Cursor Updated At"},"cursor_nm_id":{"anyOf":[{"maximum":2000000000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"cursor.nmID of the previous answer (leave empty for the first page).","title":"Cursor Nm Id"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Cards per page (1 to 100).","title":"Limit"}},"title":"list_product_cardsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}