API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

淘客以图片搜索同款产品

调用权限:核心接口会员卡调用
接口使用场景等说明:

根据您提供的一个产品图片(通常是产品主图,但不限于淘宝产品图),找出淘宝天猫上同款的有佣金的淘客商品。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/tbk/picsimilaritem 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
pic String http://...img 你要找同款或近似款的商品图片,支持格式有png,jpg,jpeg,bmp,gif,webp。可以是http开始的图片网络地址(请urlencode编码),也可以是post提交的base64编码的图片内容。图片像素分辨率必须介于100-4000之间,最大不要超过2M。推荐你自己本地服务器上的图片url地址。
relationId String 5668841122 淘客渠道ID
page Number 1 页码,默认1
pageSize Number 20 每页返回值,默认10,最大20
region String   您自己选中的图片区域,格式为x1,x2,y1,y2, 其中x1,y1 是左上角的点,x2,y2是右下角的点。如90,316,156,506,比如现在有一些应用在一张图片上切出多个区域,分别推荐图中的衣服,手提包,拉杆箱等等。
fields String 1 可选值空或1或指定字段名,当您不需要返回那么多字段时,可以指定字段返回或设为1返回主要字段。默认PicUrl,ReservePrice,Title,Url,ZkFinalPrice字段必返回。

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/tbk/picsimilaritem?vekey=xxxx&fields=&pic=https:%2F%2Fimg.alicdn.com%2Fbao%2Fuploaded%2Fi3%2F3937219703%2FO1CN01eRAhx72LY1nulcbwC_%21%213937219703-0-C2M.jpg 

使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/tbk/picsimilaritem?vekey=xxxx&fields=&pic=https:%2F%2Fimg.alicdn.com%2Fbao%2Fuploaded%2Fi3%2F3937219703%2FO1CN01eRAhx72LY1nulcbwC_%21%213937219703-0-C2M.jpg";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流,不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/tbk/picsimilaritem?vekey=xxxx&fields=&pic=https:%2F%2Fimg.alicdn.com%2Fbao%2Fuploaded%2Fi3%2F3937219703%2FO1CN01eRAhx72LY1nulcbwC_%21%213937219703-0-C2M.jpg";
        // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时,毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests,支持访问http,https网页:

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/tbk/picsimilaritem?vekey=xxxx&fields=&pic=https:%2F%2Fimg.alicdn.com%2Fbao%2Fuploaded%2Fi3%2F3937219703%2FO1CN01eRAhx72LY1nulcbwC_%21%213937219703-0-C2M.jpg"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值(JSON)

参数名称 参数类型 示例值 描述
RankScore String 0.98 产品近似比率
CategoryName String 中筒袜 分类名
CommissionRate Number 310 佣金,千位表示法,310表示3.1%
CouponAmount Number 10 优惠券面额,无券时值0
CouponEndTime String 2023-01-02 优惠券结束时间
CouponInfo String 满3.0元减2.0元 优惠券描述
CouponRemainCount Number 2900 优惠券余量
CouponStartFee String 3.00 优惠券起用金额
CouponStartTime String 2022-12-03 优惠券起始时间
CouponTotalCount String 5000 优惠券总量
ItemId Number 684757302845 产品ID
LevelOneCategoryName String 女士内衣 叶子分类名
MaxCommission Object   高佣信息
MaxCommissionRate String 20.4 商品信息-最优佣金率。如:20.4表示佣金率为20.4%。
MaxCommissionClickUrl String s.click... 商品信息-链接-最优佣金率宝贝推广链接。
MaxCommissionCouponShareUrl String uland.taobao... 商品信息-链接-最优佣金率宝贝+券二合一页面链接。
Nick String   旺旺名
PicUrl String https://img...jpg 主图
PriceAfterCoupon String 19.90 券后价。
Provcity String 浙江 杭州 商品信息-宝贝所在地。
ReservePrice String 19.9 商品信息-一口价通常显示为划线价。
SellerId String 2209041379559 卖家ID
ShopTitle String 淘工厂淘特官方直营店 店铺名称
ShortTitle String 秋冬季中长筒韩版ins 短标题(移动端建议使用)
SubTitle String xxx女装 商品子标题。
Title String 袜子女秋冬季中长筒加厚韩版ins 标题。
UserType Number 3 店铺信息-卖家类型:1天猫,0淘宝,3淘特
Volume Number 24 近30天销量
ZkFinalPrice String 19.9 折后价

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "查询成功", "data": [ { "RankScore": "0.9760", "Result": { "CategoryName": "中筒袜", "CommissionRate": "310", "CouponAmount": 0, "CouponEndTime": "", "CouponInfo": "", "CouponRemainCount": 0, "CouponStartFee": "", "CouponStartTime": "", "CouponTotalCount": "", "ItemId": "684757302845", "LevelOneCategoryName": "女士内衣/男士内衣/家居服", "MaxCommission": {}, "Nick": "淘宝特价版直营店", "PicUrl": "https://img.alicdn.com/i3/2209041379559/O1CN01O0G6aB2KU4mNsYoll_!!2209041379559-0-C2M.jpg", "PriceAfterCoupon": "19.90", "Provcity": "浙江 杭州", "ReservePrice": "19.9", "SellerId": "2209041379559", "ShopTitle": "淘工厂淘特官方直营店", "ShortTitle": "秋冬季中长筒韩版ins潮流日系袜子", "SubTitle": "", "Title": "袜子女秋冬季中长筒加厚韩版ins潮流泫雅风日系可爱复古宫廷风袜", "UserType": 3, "Volume": 24, "ZkFinalPrice": "19.9" } } ], "request_id": "w4Mfrr7" }

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部