OneCatalog API

Documentation for the public OneCatalog APIs, for developers. Two APIs are covered here:

API	Purpose	Coverage in these docs
Wiki API	Reference data for products, brands, categories, collections, countries, units of measurement, specifications and product types.	Full — all methods.
B2B API	The B2B platform for suppliers and retailers.	Only the public "Prices and stock by key" method (share-products/{url_key}). The other methods are available to authorized partners and are not included here.

Base URLs

API	Base URL
Wiki	https://api.onecatalog.net/wiki
B2B	https://api.onecatalog.net/b2b

Response localization

Both APIs support multilingual responses through the lang query parameter. Available values:

Code	Language
ru	Russian (default)
en	English
ar	Arabic
zh	Chinese
kk	Kazakh

Example:

curl "https://api.onecatalog.net/wiki/v1/products/?lang=en"

Responses include a meta.i18n block with the language that was actually applied and the fallback language.

Authentication

• Wiki API — most methods are public. For extended fields, pass an API key in the api-key query parameter or the X-API-Key header.
• B2B API (public share-products) — access by the price-list url_key; an additional private_key can be passed as a query parameter when required.

Response format

Responses are returned as JSON. Many Wiki methods support the response_fmt parameter (json, yaml, yml, xml) and file export (is_download=1). Pagination uses start and limit.

tip

The Wiki API and B2B API sections on the left list every method with its parameters, response schemas and request examples. Each method has a button to send a request straight from the docs.