品列表的

POST

/v3/product/list

用于获取所有商品列表的方法。

如果使用 offer_id 或 product_id 进行筛选，则无需填写其他参数。
每次请求只能使用一组标识符，且商品数量不能超过 1000 个。

如果不使用标识符进行查询，则需在后续请求中指定 limit 和 last_id。

请求参数

Header 参数

Body 参数application/json

示例

{
    "filter": {
        "offer_id": [
            "136748"
        ],
        "product_id": [
            "223681945"
        ],
        "visibility": "ALL"
    },
    "last_id": "",
    "limit": 100
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-seller.ozon.ru/v3/product/list' \
--header 'Client-Id;' \
--header 'Api-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filter": {
        "offer_id": [
            "136748"
        ],
        "product_id": [
            "223681945"
        ],
        "visibility": "ALL"
    },
    "last_id": "",
    "limit": 100
}'

返回响应

🟢200成功

application/json

品列表的

Body

示例

{
    "result": {
        "items": [
            {
                "archived": true,
                "has_fbo_stocks": true,
                "has_fbs_stocks": true,
                "is_discounted": true,
                "offer_id": "136748",
                "product_id": 223681945,
                "quants": [
                    {
                        "quant_code": "string",
                        "quant_size": 0
                    }
                ]
            }
        ],
        "total": 1,
        "last_id": "bnVсbA=="
    }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🔴500服务器错误

修改于 2025-06-10 08:30:31

上传或更新商品图片

按SKU获得商品的内容排名