文档中心 > API类目 > 用户增长

taobao.pc.seo.item.query (seo获取商品信息)

seo获取商品信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
req SeoItemRequest 必须 请求对象
  • └ item_ids
  • String []
  • 可选
  • ["123","456"]
  • 商品列表,可指定商品,单次最多50条, 指定商品时batch和limit和为空
  • └ batch
  • String
  • 可选
  • batch_1_xx
  • 查询批次, 调用方自己保障含义,同一批次查询会根据当前进度获取最新数据,有效期90天,未指定商品必填
  • └ limit
  • Number
  • 可选
  • 100
  • 返回条数,单次最多100条,未指定商品必填
  • └ source
  • String
  • 必须
  • xx
  • 请求来源, 联系接口管理员分配
  • └ update_time
  • Number
  • 可选
  • 1722328654779
  • 更新时间,毫秒时间戳

响应参数

名称 类型 示例值 描述
result Result 请求响应信息
  • └ code
  • Number
  • 200
  • code
  • data
  • SeoItemResult []
  • 商品信息
  • └ reserve_price
  • String
  • 10.00
  • 商品价格(元)
  • sku_list
  • ItemSkuTable []
  • sku信息
  • └ sku_pc_url
  • String
  • https://xxx.htm
  • sku pc端链接
  • └ price
  • String
  • 10.00
  • sku价格(元)
  • └ sku_mobile_url
  • String
  • https://xxx.htm
  • sku移动端链接
  • └ sku_id
  • String
  • xxx
  • sku主键
  • └ property_pic
  • String
  • https://xxx.jpg
  • sku颜色属性图片
  • └ properties
  • String []
  • sku属性,格式:属性:属性值
  • └ delivery_time
  • String
  • 5
  • 发货时效(小时)
  • └ city
  • String
  • 上海
  • 发货城市
  • └ pict_url
  • String
  • https://xxx.jpg
  • 商品主图
  • └ item_pc_url
  • String
  • https://xxx.htm
  • 商品PC端链接
  • └ title
  • String
  • xxx
  • 商品标题
  • └ sold_quantity
  • String
  • 1000
  • 销量
  • └ tags
  • String []
  • 商品服务保障标签
  • └ item_id
  • String
  • xxx
  • 商品主键
  • └ secure_trade_fast_post_fee
  • String
  • 5.00
  • 快递费用
  • └ shop_id
  • String
  • xxx
  • 归属商家信息
  • └ item_mobile_url
  • String
  • https://xxx.htm
  • 商品移动端链接
  • └ update_time
  • Number
  • 1722328654779
  • 最后修改时间,毫秒时间戳
  • └ category
  • String
  • 女装>>裤子>>西裤
  • 类目1>>....>>类目n
  • └ success
  • Boolean
  • true
  • success
  • └ message
  • String
  • OK
  • message
  • └ attributes
  • String
  • {\"total\":225623814,\"offset\":10}
  • offset: 当前已抓取数量, total: 总数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PcSeoItemQueryRequest req = new PcSeoItemQueryRequest();
PcSeoItemQueryRequest.SeoItemRequest obj1 = new PcSeoItemQueryRequest.SeoItemRequest();
obj1.setItemIds(""123","456"");
obj1.setBatch("batch_1_xx");
obj1.setLimit(100L);
obj1.setSource("xx");
obj1.setUpdateTime(1722328654779L);
req.setReq(obj1);
PcSeoItemQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<pc_seo_item_query_response>
    <result>
        <code>200</code>
        <data>
            <seo_item_result>
                <reserve_price>10.00</reserve_price>
                <sku_list>
                    <item_sku_table>
                        <sku_pc_url>https://xxx.htm</sku_pc_url>
                        <price>10.00</price>
                        <sku_mobile_url>https://xxx.htm</sku_mobile_url>
                        <sku_id>xxx</sku_id>
                        <property_pic>https://xxx.jpg</property_pic>
                    </item_sku_table>
                </sku_list>
                <delivery_time>5</delivery_time>
                <city>上海</city>
                <pict_url>https://xxx.jpg</pict_url>
                <item_pc_url>https://xxx.htm</item_pc_url>
                <title>xxx</title>
                <sold_quantity>1000</sold_quantity>
                <item_id>xxx</item_id>
                <secure_trade_fast_post_fee>5.00</secure_trade_fast_post_fee>
                <shop_id>xxx</shop_id>
                <item_mobile_url>https://xxx.htm</item_mobile_url>
                <update_time>1722328654779</update_time>
                <category>女装&gt;&gt;裤子&gt;&gt;西裤</category>
            </seo_item_result>
        </data>
        <success>true</success>
        <message>OK</message>
        <attributes>{\&quot;total\&quot;:225623814,\&quot;offset\&quot;:10}</attributes>
    </result>
</pc_seo_item_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.1000 参数错误 检查传入参数合法性
isv.1001 指定商品数量超过最大限制 不要超过100
isv.1002 并发请求过高 降低并发,稍后再试
isv.1003 商品ID解析失败 传入正确商品ID
isv.1004 更新时间字段无效 传入正确毫秒时间戳格式
isv.1005 远程服务执行错误 稍后再试或联系管理员
isv.1006 商品未找到 商品可能已下架或传入商品ID有误

API工具

如何获得此API

FAQ

返回
顶部