万邦阿里妈妈按关键字或网址搜索商品 API 返回值说明

item_search-按关键字或网址搜索商品 [查看演示] API测试工具

onebound.alimama.item_search

公共参数

请求地址: https://api.onebound.cn/alimama/api_call.php

名称 类型 必须 描述
keyString调用key
secretString调用密钥
api_nameStringAPI接口名称[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本
请求参数

请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明:q:搜索关键字,支持url
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_credit,_income,_prom,_comm]
  (bid:总价,sale:销量,credit信用/人气,income收入,月推广量,comm月支出佣金。加_前缀为从大到小排序)
page:
seller_info:不支持
nick:不支持
ppath:不支持
imgid:不支持
filter:参数数组:(以:分隔键和值,以;分隔参数组,支持的参数如下:
    startTkRate:0,收入比率大于
    endTkRate:100,收入比率少于
    b2c:1,天猫
    startBiz30day:10,月销量
    hPayRate30:1,月成交转化率高于行业均值
    freeShipment:1,包邮
    dpyhq:1,店铺优惠券
    yxjh:1,营销和定向计划
    loc:北京,发货地)

响应参数
名称 类型 是否隐私 示例值 描述
num_iidBigint586359092786商品ID
titleString短袖女装2019新款夏纯棉面料宽松潮印花t恤白色学生上衣定制covea商品标题
pic_urlString//img.alicdn.com/bao/uploaded/i4/2139349365/O1CN01UjNbFz2J3DeQhyw5u_!!2-item_pic.png商品图片
promotion_priceFloat49.9优惠价
priceInt169价格
salesInt1557销量
sample_idBigint234367557商品风格标识ID
seller_nickStringcovea旗舰店卖家昵称
seller_idBigint2139349365卖家ID
shop_titleStringcovea旗舰店店铺标题
numInt1303
detail_urlStringhttp://item.taobao.com/item.htm?id=586359092786商品链接
shop_typeStringB店铺类型:C=淘宝,B=天猫
tk_rateInt30
tk_comm_feeFloat14.97
coupon_amountInt20
coupon_infoString满49元减20元优惠信息
coupon_start_feeInt49
coupon_start_timeDate2019-03-20优惠开始时间
coupon_end_timeDate2019-03-25优惠结束时间
coupon_totalInt10000
coupon_leftInt9700
dxjhInt0
请求示例
	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api.onebound.cn/alimama/api_call.php?key=<您自己的apiKey>&secret=<您自己的apiSecret>&api_name=item_search&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="
<?php
$method = "GET";
// 请求示例 url 默认请求参数已经URL编码处理
$url = "https://api.onebound.cn/alimama/api_call.php?key=<您自己的apiKey>&secret=<您自己的apiSecret>&api_name=item_search&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
<?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 http://api.onebound.cn/taobao/demo/sdk2020/onebound-api-sdk.zip
include ("ObApiClient.php");

$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api.onebound.cn/";
$obapi->api_urls = array("http://api.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时,是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;

$api_data = $obapi->exec(
                array(
	                "api_type" =>"alimama",
	                "api_name" =>"item_search",
	                "api_params"=>array (
  'q' => '女装',
  'start_price' => '0',
  'end_price' => '0',
  'page' => '1',
  'cat' => '0',
  'discount_only' => '',
  'sort' => '',
  'page_size' => '',
  'seller_info' => '',
  'nick' => '',
  'ppath' => '',
  'imgid' => '',
  'filter' => '',
)
                )
            );
 var_dump($api_data);
?>
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;

public class Example {
	private static String readAll(Reader rd) throws IOException {
		StringBuilder sb = new StringBuilder();
		int cp;
		while ((cp = rd.read()) != -1) {
			sb.append((char) cp);
		}
		return  sb.toString();
	}
	public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		conn.setDoOutput(true);
		conn.setDoInput(true);
		PrintWriter out = new PrintWriter(conn.getOutputStream());
		out.print(body);
		out.flush();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static void main(String[] args) throws IOException, JSONException {
		// 请求示例 url 默认请求参数已经URL编码处理
		String url = "https://api.onebound.cn/alimama/api_call.php?key=<您自己的apiKey>&secret=<您自己的apiSecret>&api_name=item_search&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}
//using System.Net.Security;
//using System.Security.Cryptography.X509Certificates;
private const String method = "GET";
static void Main(string[] args)
{
	String bodys = "";
	// 请求示例 url 默认请求参数已经做URL编码
	String url = "https://api.onebound.cn/alimama/api_call.php?key=<您自己的apiKey>&secret=<您自己的apiSecret>&api_name=item_search&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=";
	HttpWebRequest httpRequest = null;
	HttpWebResponse httpResponse = null; 
	if (url.Contains("https://"))
	{
		ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
		httpRequest = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url));
	}
	else
	{
		httpRequest = (HttpWebRequest)WebRequest.Create(url);
	}
	httpRequest.Method = method;
	if (0 < bodys.Length)
	{
		byte[] data = Encoding.UTF8.GetBytes(bodys);
		using (Stream stream = httpRequest.GetRequestStream())
		{
		stream.Write(data, 0, data.Length);
		}
	}
	try
	{
		httpResponse = (HttpWebResponse)httpRequest.GetResponse();
	}
	catch (WebException ex)
	{
		httpResponse = (HttpWebResponse)ex.Response;
	}
	Console.WriteLine(httpResponse.StatusCode);
	Console.WriteLine(httpResponse.Method);
	Console.WriteLine(httpResponse.Headers);
	Stream st = httpResponse.GetResponseStream();
	StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
	Console.WriteLine(reader.ReadToEnd());
	Console.WriteLine("\n");
}
public static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
{
	return true;
}
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api.onebound.cn/alimama/api_call.php?key=<您自己的apiKey>&secret=<您自己的apiSecret>&api_name=item_search&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)
响应示例
异常示例
错误码解释
API 工具
如何获得此API
立即开通 有疑问联系客服QQ:583964941(微信同号)

Powered by:万邦 www.onebound.cn All Rights Reserved. QQ:583964941

   万邦淘宝API数据接口,电商代购商品数据调用.