TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkInterestItemsGetRequest req = new TbkInterestItemsGetRequest();
req.setPageSize(20L);
req.setPageNo(1L);
req.setMaterialId(123L);
req.setAdzoneId(123L);
req.setDeviceType("IMEI");
req.setDeviceValue("xxx");
TbkInterestItemsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TbkInterestItemsGetRequest req = new TbkInterestItemsGetRequest();
req.PageSize = 20L;
req.PageNo = 1L;
req.MaterialId = 123L;
req.AdzoneId = 123L;
req.DeviceType = "IMEI";
req.DeviceValue = "xxx";
TbkInterestItemsGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TbkInterestItemsGetRequest;
$req->setPageSize("20");
$req->setPageNo("1");
$req->setMaterialId("123");
$req->setAdzoneId("123");
$req->setDeviceType("IMEI");
$req->setDeviceValue("xxx");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.tbk.interest.items.get' \
-d 'partner_id=apidoc' \
-d 'sign=846F78F671FC0EE0F5E351B4EE6C223A' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-30+00%3A24%3A12' \
-d 'v=2.0' \
-d 'adzone_id=123' \
-d 'device_type=IMEI' \
-d 'device_value=xxx' \
-d 'material_id=123' \
-d 'page_no=1' \
-d 'page_size=20'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TbkInterestItemsGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.page_size=20
req.page_no=1
req.material_id=123
req.adzone_id=123
req.device_type="IMEI"
req.device_value="xxx"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.tbk.interest.items.get");
add_param(pRequest,"page_size","20");
add_param(pRequest,"page_no","1");
add_param(pRequest,"material_id","123");
add_param(pRequest,"adzone_id","123");
add_param(pRequest,"device_type","IMEI");
add_param(pRequest,"device_value","xxx");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.tbk.interest.items.get', {
	'page_size':'20',
	'page_no':'1',
	'material_id':'123',
	'adzone_id':'123',
	'device_type':'IMEI',
	'device_value':'xxx'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

<tbk_interest_items_get_response>
    <result_list>
        <map_data>
            <item_id>qeqscd1231-uqwenqe</item_id>
            <item_basic_info>
                <title>复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款</title>
                <short_title>九分裤显瘦高腰韩版</short_title>
                <pict_url>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</pict_url>
                <white_image>https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</white_image>
                <level_one_category_id>1</level_one_category_id>
                <level_one_category_name>美妆</level_one_category_name>
                <category_id>162201</category_id>
                <category_name>牛仔裤</category_name>
                <seller_id>123</seller_id>
                <user_type>1</user_type>
                <shop_title>魔黛娅内衣旗舰店</shop_title>
                <volume>30</volume>
                <sub_title>吉品鲍鱼 关西参</sub_title>
                <brand_name>淘宝心选</brand_name>
                <annual_vol>1万+</annual_vol>
            </item_basic_info>
            <price_promotion_info>
                <reserve_price>102.00</reserve_price>
                <zk_final_price>79.9</zk_final_price>
                <final_promotion_price>69.9</final_promotion_price>
                <final_promotion_path_list>
                    <final_promotion_path_map_data>
                        <promotion_title>商品券</promotion_title>
                        <promotion_desc>满7999减1300</promotion_desc>
                        <promotion_fee>1300.00</promotion_fee>
                        <promotion_start_time>1661184000000</promotion_start_time>
                        <promotion_end_time>1661788799000</promotion_end_time>
                        <promotion_id>xx</promotion_id>
                    </final_promotion_path_map_data>
                </final_promotion_path_list>
                <future_activity_promotion_price>99.5</future_activity_promotion_price>
                <future_activity_promotion_path_list>
                    <future_activity_promotion_path_map_data>
                        <promotion_title>商品券</promotion_title>
                        <promotion_desc>满7999减1300</promotion_desc>
                        <promotion_fee>1300.00</promotion_fee>
                        <promotion_start_time>1661184000000</promotion_start_time>
                        <promotion_end_time>1661788799000</promotion_end_time>
                    </future_activity_promotion_path_map_data>
                </future_activity_promotion_path_list>
                <promotion_tag_list>
                    <promotion_tag_map_data>
                        <tag_name>88VIP</tag_name>
                    </promotion_tag_map_data>
                </promotion_tag_list>
                <predict_rounding_up_price>56.1</predict_rounding_up_price>
                <predict_rounding_up_price_desc>需买1件</predict_rounding_up_price_desc>
                <more_promotion_list>
                    <more_promotion_map_data>
                        <promotion_title>满件折</promotion_title>
                        <promotion_desc>2件9折</promotion_desc>
                        <promotion_start_time>1661222400000</promotion_start_time>
                        <promotion_end_time>1662393600000</promotion_end_time>
                        <promotion_id>xx</promotion_id>
                    </more_promotion_map_data>
                </more_promotion_list>
                <predict_rounding_up_path_list>
                    <predict_rounding_up_path_map_data>
                        <promotion_title>店铺优惠</promotion_title>
                        <promotion_desc>再买1件，可参与2件5折</promotion_desc>
                    </predict_rounding_up_path_map_data>
                </predict_rounding_up_path_list>
            </price_promotion_info>
            <publish_info>
                <income_rate>5.50</income_rate>
                <click_url>//item.taobao.com/item.htm?id=556633720749&amp;scm=1007.16190.92234.0&amp;pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&amp;app_pvid=0ab0fac715095507006577956e</click_url>
                <coupon_share_url>//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&amp;mt=1&amp;app_pvid=0ab0fac715095507006577956e&amp;ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8</coupon_share_url>
                <sp_campaign_list>
                    <sp_campaign>
                        <sp_cid>123</sp_cid>
                        <sp_name>定向计划活动1</sp_name>
                        <sp_rate>1550表示15.5%</sp_rate>
                        <sp_lock_status>0</sp_lock_status>
                        <sp_apply_link>http://pub.alimama.com/portal/promo/shop/campaign/detail.htm?mode=info&amp;campaignId=1000492470&amp;creatorId=98836808&amp;breadcrumb=false</sp_apply_link>
                        <sp_status>1</sp_status>
                    </sp_campaign>
                </sp_campaign_list>
                <future_activity_commission_rate>1550表示15.5%</future_activity_commission_rate>
                <future_activity_time>1665504000000</future_activity_time>
                <income_info>
                    <commission_rate>55</commission_rate>
                    <commission_amount>12</commission_amount>
                    <subsidy_rate>11</subsidy_rate>
                    <subsidy_amount>4</subsidy_amount>
                    <subsidy_upper_limit>10</subsidy_upper_limit>
                </income_info>
                <cpa_reward_type>0 1 2</cpa_reward_type>
                <cpa_reward_amount>1.11 2.22 3.21</cpa_reward_amount>
            </publish_info>
            <tmall_rank_info>
                <tmall_rank_text>白茶热销榜·第5名</tmall_rank_text>
                <tmall_rank_url>https://pages.tmall.com/wow/a/act/tmall/dailygroup/16220/16661/wupr?wh_pid=daily-459438&amp;disableNav=YES</tmall_rank_url>
            </tmall_rank_info>
            <presale_info>
                <presale_start_time>1567440000000</presale_start_time>
                <presale_end_time>1567440000000</presale_end_time>
                <presale_tail_start_time>1567440000000</presale_tail_start_time>
                <presale_tail_end_time>1567440000000</presale_tail_end_time>
                <presale_deposit>100</presale_deposit>
                <presale_discount_fee_text>付定金立减5元</presale_discount_fee_text>
            </presale_info>
            <favorites_info>
                <total_count>100</total_count>
                <favorites_list>
                    <favorites_detail>
                        <favorites_id>12334</favorites_id>
                        <favorites_title>测试选品库</favorites_title>
                    </favorites_detail>
                </favorites_list>
            </favorites_info>
            <topn_info>
                <topn_quantity>3000</topn_quantity>
                <topn_total_count>3000</topn_total_count>
                <topn_start_time>1937297392332</topn_start_time>
                <topn_end_time>1937297392332</topn_end_time>
                <topn_rate>30</topn_rate>
            </topn_info>
            <scope_info>
                <superior_brand>1</superior_brand>
            </scope_info>
        </map_data>
    </result_list>
    <is_default>false</is_default>
    <total_count>100</total_count>
    <uvid_msg>123</uvid_msg>
</tbk_interest_items_get_response>

{
    "tbk_interest_items_get_response":{
        "result_list":{
            "map_data":[
                {
                    "item_id":"qeqscd1231-uqwenqe",
                    "item_basic_info":{
                        "title":"复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款",
                        "short_title":"九分裤显瘦高腰韩版",
                        "pict_url":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                        "white_image":"https:\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                        "level_one_category_id":1,
                        "level_one_category_name":"美妆",
                        "category_id":162201,
                        "category_name":"牛仔裤",
                        "seller_id":123,
                        "user_type":1,
                        "shop_title":"魔黛娅内衣旗舰店",
                        "volume":30,
                        "sub_title":"吉品鲍鱼 关西参",
                        "brand_name":"淘宝心选",
                        "annual_vol":"1万+"
                    },
                    "price_promotion_info":{
                        "reserve_price":"102.00",
                        "zk_final_price":"79.9",
                        "final_promotion_price":"69.9 ",
                        "final_promotion_path_list":{
                            "final_promotion_path_map_data":[
                                {
                                    "promotion_title":"商品券",
                                    "promotion_desc":"满7999减1300",
                                    "promotion_fee":"1300.00",
                                    "promotion_start_time":"1661184000000",
                                    "promotion_end_time":"1661788799000",
                                    "promotion_id":"xx"
                                }
                            ]
                        },
                        "future_activity_promotion_price":"99.5",
                        "future_activity_promotion_path_list":{
                            "future_activity_promotion_path_map_data":[
                                {
                                    "promotion_title":"商品券",
                                    "promotion_desc":"满7999减1300",
                                    "promotion_fee":"1300.00",
                                    "promotion_start_time":"1661184000000",
                                    "promotion_end_time":"1661788799000"
                                }
                            ]
                        },
                        "promotion_tag_list":{
                            "promotion_tag_map_data":[
                                {
                                    "tag_name":"88VIP"
                                }
                            ]
                        },
                        "predict_rounding_up_price":"56.1",
                        "predict_rounding_up_price_desc":"需买1件",
                        "more_promotion_list":{
                            "more_promotion_map_data":[
                                {
                                    "promotion_title":"满件折",
                                    "promotion_desc":"2件9折",
                                    "promotion_start_time":"1661222400000",
                                    "promotion_end_time":"1662393600000",
                                    "promotion_id":"xx"
                                }
                            ]
                        },
                        "predict_rounding_up_path_list":{
                            "predict_rounding_up_path_map_data":[
                                {
                                    "promotion_title":"店铺优惠",
                                    "promotion_desc":"再买1件，可参与2件5折"
                                }
                            ]
                        }
                    },
                    "publish_info":{
                        "income_rate":"5.50",
                        "click_url":"\/\/item.taobao.com\/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e",
                        "coupon_share_url":"\/\/uland.taobao.com\/coupon\/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8",
                        "sp_campaign_list":{
                            "sp_campaign":[
                                {
                                    "sp_cid":"123",
                                    "sp_name":"定向计划活动1",
                                    "sp_rate":"1550表示15.5%",
                                    "sp_lock_status":"0",
                                    "sp_apply_link":"http:\/\/pub.alimama.com\/portal\/promo\/shop\/campaign\/detail.htm?mode=info&campaignId=1000492470&creatorId=98836808&breadcrumb=false",
                                    "sp_status":"1"
                                }
                            ]
                        },
                        "future_activity_commission_rate":"1550表示15.5%",
                        "future_activity_time":"1665504000000",
                        "income_info":{
                            "commission_rate":"55",
                            "commission_amount":"12",
                            "subsidy_rate":"11",
                            "subsidy_amount":"4",
                            "subsidy_upper_limit":"10"
                        },
                        "cpa_reward_type":"0 1 2",
                        "cpa_reward_amount":"1.11 2.22 3.21"
                    },
                    "tmall_rank_info":{
                        "tmall_rank_text":"白茶热销榜·第5名",
                        "tmall_rank_url":"https:\/\/pages.tmall.com\/wow\/a\/act\/tmall\/dailygroup\/16220\/16661\/wupr?wh_pid=daily-459438&disableNav=YES"
                    },
                    "presale_info":{
                        "presale_start_time":1567440000000,
                        "presale_end_time":1567440000000,
                        "presale_tail_start_time":1567440000000,
                        "presale_tail_end_time":1567440000000,
                        "presale_deposit":"100",
                        "presale_discount_fee_text":"付定金立减5元"
                    },
                    "favorites_info":{
                        "total_count":100,
                        "favorites_list":{
                            "favorites_detail":[
                                {
                                    "favorites_id":12334,
                                    "favorites_title":"测试选品库"
                                }
                            ]
                        }
                    },
                    "topn_info":{
                        "topn_quantity":3000,
                        "topn_total_count":3000,
                        "topn_start_time":"1937297392332",
                        "topn_end_time":"1937297392332",
                        "topn_rate":"30"
                    },
                    "scope_info":{
                        "superior_brand":"1"
                    }
                }
            ]
        },
        "is_default":"false",
        "total_count":100,
        "uvid_msg":"123"
    }
}

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

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}