请求地址: https://api-gw.fan-b.com/1688/item_search_best
请求参数:rankid=1031918&rank_type=hot&language=en
参数说明:rankid:榜单IDrank_type:榜单类型,complex综合榜,hot热卖榜,goodPrice好价榜
Version: Date:2025-2-28
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"
<?php // 请求示例 url 默认请求参数已经URL编码处理 // 本示例代码未加密secret参数明文传输,若要加密请参考:https://open.fan-b.com/help/demo/sdk/demo-sign.php $method = "GET"; $url = "https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"; $curl = curl_init(); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE); 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下载地址 https://open.fan-b.com/help/demo/sdk/onebound-api-sdk.zip include ("ObApiClient.php"); $obapi = new otao\ObApiClient(); $obapi->api_url = "http://api-gw.fan-b.com/"; $obapi->api_urls = array("http://api-gw.fan-b.com/","http://api-1.fan-b.com/");//备用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" =>"1688", "api_name" =>"item_search_best", "api_params"=>array ( 'rankid' => '1031918', 'rank_type' => 'hot', 'language' => 'en', ) ) ); 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-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"; 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-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"; 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-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)
url := fmt.Sprintf("https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en", params) req, err := http.NewRequest("GET", url, nil) if err != nil { panic(err) } req.Header.Set("Authorization", apiKey) client := &http.Client{} resp, err := client.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body))
fetch('https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({"rankid":"1031918","rank_type":"hot","language":"en"})// request parameters here }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error(error));
<script src="js/obapi.js"></script> <script type="text/javascript"> obAPI.config({ debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。 api_url: "https://api-gw.fan-b.com", // api_key: "<您自己的apiKey>", // 必填, api_secret: "<您自己的apiSecret>", // lang: "cn", // timestamp: "", // 必填,生成签名的时间戳 nonceStr: "", // 必填,生成签名的随机串 signature: "",// 必填,签名 jsApiList: [] // 必填,需要使用的JS接口列表 }); </script> <div id="api_data_box"></div> <script type="text/javascript"> obAPI.exec( { "api_type":"1688", "api_name" : "item_search_best", "api_params": {"rankid":"1031918","rank_type":"hot","language":"en"}//rankid=1031918&rank_type=hot&language=en,#具体参数请参考文档说明 }, function(e){ document.querySelector("#api_data_box").innerHTML=JSON.stringify(e) } ); </script>
require "net/http" require "uri" url = URI("https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body
import Foundation let url = URL(string: "https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en")! let task = URLSession.shared.dataTask(with: url) { data, response, error in guard let data = data else { print("Error: No data was returned") return } if let data = String(data: data, encoding: .utf8) { print(data) } } task.resume()
NSURL *myUrl = [NSURL URLWithString:@"https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"]; NSMutableURLRequest *request=[NSMutableURLRequest requestWithURL:myUrl cachePolicy:NSURLRequestReloadIgnoringCacheData timeoutInterval:60.0]; [request setHTTPMethod:@"GET"]; NSError *error; NSURLResponse *response; NSData *data = [NSURLConnection sendSynchronousRequest:request returningResponse:&response error:&error]; NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]; NSLog(@"%@",result);
#include<stdio.h> #include <stdlib.h> #include<string.h> #include<curl/curl.h> int main(){ CURL *curl; CURLcode res; struct curl_slist *headers=NULL; char url[] = "https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"; curl_global_init(CURL_GLOBAL_ALL); curl = curl_easy_init(); if(curl) { curl_easy_setopt(curl, CURLOPT_URL,url); headers = curl_slist_append(headers, "Content-Type: application/json"); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers); res = curl_easy_perform(curl); if(res != CURLE_OK){ printf("curl_easy_perform(): %s\n",curl_easy_strerror(res)); } curl_easy_cleanup(curl); } curl_global_cleanup(); return 0; }
#include<iostream> #include<string> #include<curl/curl.h> using namespace std; static size_t Data(void *ptr, size_t size, size_t nmemb, string *stream) { std::size_t realSize = size *nmemb; auto *realPtr = reinterpret_cast<char *>(ptr); for (std::size_t i=0;i<realSize;++i) { *(stream) += *(realPtr + i); } return realSize; } int main(){ CURL *curl; CURLcode result; string readBuffer; curl = curl_easy_init(); if(curl) { curl_easy_setopt(curl, CURLOPT_URL, "https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"); curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, Data); curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer); result = curl_easy_perform(curl); if(result == CURLE_OK) { cout<<readBuffer<<endl; }else{ cerr<<"curl_easy error:"<<curl_easy_strerror(result)<<endl; } curl_easy_cleanup(curl); } return 0; }
const https = require("https"); https.get("https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en", (resp) => { let data = ""; resp.on("data", (chunk) => { data += chunk; }); resp.on("end", () => { console.log(data); }); }).on("error", (err) => { console.log("Error: " + err.message); });
import java.net.HttpURLConnection import java.net.URL fun main() { val url = URL("https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en") val con = url.openConnection() as HttpURLConnection con.requestMethod = "GET" val responseCode = con.responseCode if (responseCode == HttpURLConnection.HTTP_OK) { // success val inputLine = con.inputStream.bufferedReader().use { it.readText() } println(inputLine) } else { println("GET request failed") } }
use std::io::{self, Read}; use reqwest; fn main() -> io::Result<()> { let mut resp = reqwest::get("https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en")?; let mut content = String::new(); resp.read_to_string(&mut content)?; println!("{}", content); Ok(()) }
library(httr) r <- GET("https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en") content(r)
url = "https://api-gw.fan-b.com/1688/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&rankid=1031918&rank_type=hot&language=en"; response = webread(url); disp(response);
{ "items": { "rankid": "1031918", "rank_type": "hot", "limit": 20, "rank_name": "Hot List", "item": [ { "title": "【候麦的春天】歌铭法式娃娃领衬衫春季新款复古蕾丝上衣女Y1122F", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01ZGXBxE1vEdAHuY3jh_!!961166141-0-cib.jpg", "sales": 1310, "num_iid": 767902905173, "sort": 1, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/767902905173.html" }, { "title": "24春夏自带珍珠的低调光泽和精致感白衬衫女 现货", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01JuBWcG2DSydjg7keA_!!2200705378609-0-cib.jpg", "sales": 1192, "num_iid": 680634514460, "sort": 2, "goods_Score": "4.8", "detail_url": "https://detail.1688.com/offer/680634514460.html" }, { "title": "日本JK制服长袖白衬衫 日系校服 长袖尖领方领角襟 不透", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01VoPver1eWAvNavQJR_!!1946823878-0-cib.jpg", "sales": 1498, "num_iid": 38972319718, "sort": 3, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/38972319718.html" }, { "title": "蓝色复古刺绣长袖衬衫女2025春季新款韩版宽松显瘦百搭上衣衬衣", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01wlm4YT20mai4tTr1q_!!2918146892-0-cib.jpg", "sales": 1268, "num_iid": 870050983821, "sort": 4, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/870050983821.html" }, { "title": "【圣水洞韩系格子衬衫】歌铭高级感春季新款女装长袖衬衣女W143B", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01ATR4pX1vEdDqcM198_!!961166141-0-cib.jpg", "sales": 903, "num_iid": 826428597218, "sort": 5, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/826428597218.html" }, { "title": "司南 早春新款 法式大尖领双拉链宽松显瘦竖条纹衬衫小众 SN7083", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN0172iSRi1DYvizWpJIx_!!2207919270229-0-cib.jpg", "sales": 1398, "num_iid": 872281415322, "sort": 6, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/872281415322.html" }, { "title": "3th Morning 早春新款 韩系刺绣小标经典学院衬衫ZY2607", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01WA5UuJ21ayH2BSytD_!!2211360847002-0-cib.jpg", "sales": 759, "num_iid": 863607459891, "sort": 7, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/863607459891.html" }, { "title": "【春日花房】歌铭法式衬衫春季女装高级感衬衣长袖女式上衣Y1588F", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01KpDfbT1vEdDQr3D6u_!!961166141-0-cib.jpg", "sales": 748, "num_iid": 820003510268, "sort": 8, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/820003510268.html" }, { "title": "【爆款升级 南法白月光】歌铭法式衬衫高级感蕾丝花边衬衣Y1626F", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01q2DOqd1vEdDa7iRmm_!!961166141-0-cib.jpg", "sales": 778, "num_iid": 821820991564, "sort": 9, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/821820991564.html" }, { "title": "3th Morning 早春新款 知识分子高智风小格子刺绣衬衫ZY2591", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01wDyRqt21ayHG4DR6Y_!!2211360847002-0-cib.jpg", "sales": 613, "num_iid": 864378180513, "sort": 10, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/864378180513.html" }, { "title": "白色简约圆领系带长袖衬衫女春季2025新款韩版慵懒宽松百搭棉上衣", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN010cP85U20maiK30HGd_!!2918146892-0-cib.jpg", "sales": 1313, "num_iid": 883524948184, "sort": 12, "goods_Score": null, "detail_url": "https://detail.1688.com/offer/883524948184.html" }, { "title": "江左 被问爆 老钱风晕染飘带衬衫春季小众上衣独特超好看衬衣1307", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01aj1WWw1jENfT0lEEl_!!2214077954516-0-cib.jpg", "sales": 554, "num_iid": 889862738866, "sort": 11, "goods_Score": "4.8", "detail_url": "https://detail.1688.com/offer/889862738866.html" }, { "title": "春秋新款黑色白衬衫女韩版修身长袖工装衬衣工作服职业装正装上衣", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01XQj45Q2LyajXZO18f_!!2213051949761-0-cib.jpg", "sales": 9307, "num_iid": 673840214525, "sort": 13, "goods_Score": "4.4", "detail_url": "https://detail.1688.com/offer/673840214525.html" }, { "title": "透气凉感全亚麻衬衫女夏季新款宽松氛围感长袖上衣宝藏蓝", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01Pxm2oX2DSyi06Z7By_!!2200705378609-0-cib.jpg", "sales": 463, "num_iid": 822096303466, "sort": 14, "goods_Score": null, "detail_url": "https://detail.1688.com/offer/822096303466.html" }, { "title": "所见即所得,原厂里的禾!!!篙级感简约条纹长袖翻领衬衫上衣女", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01aSyiUA1T2RRbXUoOu_!!2216651982324-0-cib.jpg", "sales": 517, "num_iid": 830844572857, "sort": 17, "goods_Score": "4.9", "detail_url": "https://detail.1688.com/offer/830844572857.html" }, { "title": "制服衬衣基础长袖白色衬衫女新款百搭基础款工作服内搭复古衬衣女", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01nPBhSV1KxOAMEuUwv_!!2833681230-0-cib.jpg", "sales": 2035, "num_iid": 849815741287, "sort": 16, "goods_Score": "4.6", "detail_url": "https://detail.1688.com/offer/849815741287.html" }, { "title": "司南 街头雅痞风 复古水洗全棉设计感单口袋翻领牛仔衬衫 SN6985", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01RATDiX1DYvj3kYso7_!!2207919270229-0-cib.jpg", "sales": 522, "num_iid": 872405619099, "sort": 15, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/872405619099.html" }, { "title": "【北欧植物系】歌铭法式复古木耳边长袖衬衫女春季新款开衫Y1727F", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01fhimDt1vEdGtwPIYB_!!961166141-0-cib.jpg", "sales": 469, "num_iid": 883227603565, "sort": 18, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/883227603565.html" }, { "title": "江左墨绿色复古港风衬衫女显白休闲百搭纯色衬衣2025早春新品1302", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01J0TEy51jENfJcxIlG_!!2214077954516-0-cib.jpg", "sales": 555, "num_iid": 885397286550, "sort": 20, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/885397286550.html" }, { "title": "黄峥设计感拼接假两件衬衫女2025早春韩系休闲长袖开衫H1CA510029", "pic_url": "http://img.china.alibaba.com/img/ibank/O1CN01FrZmzO2MDFhUeuIs2_!!2567599793-0-cib.jpg", "sales": 566, "num_iid": 876089819144, "sort": 19, "goods_Score": "5.0", "detail_url": "https://detail.1688.com/offer/876089819144.html" } ], "_ddf": "dcsop" }, "error": "", "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:15 max:10000 all[177=15+31+131];expires:2030-10-30", "execution_time": "0.732", "server_time": "Beijing/2025-02-28 09:53:20", "client_ip": "115.153.49.244", "call_args": [ ], "api_type": "1688", "translate_language": "zh-CN", "translate_engine": "google_api", "server_memory": "3.32MB", "request_id": "1.67c117100435f", "last_id": "4113880202" }
{ "error": "item-not-found", "reason": "没找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2023-12-15 17:44:00", "call_args": [], "api_type": "1688", "request_id": "1ee0ffc041242"}