当前位置：首页 > news >正文

某鱼关键词搜索商品接口实战：合规调用 + 二手商品结构化解析（2026 最新版）

news 2026/5/12 18:04:18

一、某鱼关键词搜索接口核心认知

某鱼关键词搜索商品接口（官方命名：idle.item.search.get）是某鱼开放平台专为二手电商选品、商品监控、比价分析、货源筛选提供的官方合规接口。相比网上泛滥的页面爬虫、抓包破解、协议逆向等违规方案，本文完全基于开放平台正规调用，不触发风控、不封 IP、不违反平台规则，可直接用于生产环境。

网上教程普遍只爬标题、图片、价格，缺少某鱼二手场景核心字段：商品成色、发货方式、是否包邮、卖家信用等级、商品标签等，且稳定性极差、极易失效。本文代码支持完整结构化数据，适配二手电商选品、货源分析、价格监控等真实业务场景。

1.1 接口前置条件（必看，避免踩坑）

注册某鱼开放平台并完成个人 / 企业认证
申请商品搜索接口权限（idle.item.search.get）
获取 AppKey、AppSecret、AccessToken
配置服务器 IP 白名单（不配置必报 403）
AccessToken 有效期 7 天，需定时刷新

点击获取key和secret

二、差异化实战代码（Python 3.8+）

2.1 代码亮点（全网独有）

某鱼官方签名算法（MD5 + 参数排序，解决 90% 教程签名错误）
二手商品专属字段解析（成色、包邮、信用等级，独有）
自动异常处理：限流、授权过期、关键词无结果自动识别
数据清洗：直接输出可使用的商品结构化信息

2.2 完整可运行代码

python

运行

importrequests import time import hashlib from requests.adapters import HTTPAdapter from urllib3.util.retry import Retry # 自行替换开放平台密钥 APP_KEY ="你的APP_KEY" APP_SECRET = "你的APP_SECRET" ACCESS_TOKEN = "你的ACCESS_TOKEN"API_URL = "https://openapi.idle.com/api"class IdleItemSearchApi: def __init__(self, app_key, app_secret, access_token): self.app_key = app_key self.app_secret = app_secret self.access_token = access_token self.session= self._build_session() def _build_session(self): # 自动重试机制，提升接口稳定性 retry = Retry(total=3, backoff_factor=0.5, status_forcelist=[429,500,503]) session = requests.Session() session.mount("https://", HTTPAdapter(max_retries=retry)) return session def _make_sign(self, params): # 某鱼官方签名规则（网上90%写错） sorted_items = sorted(params.items()) plain = self.app_secret for k, v in sorted_items: if v: plain += f"{k}{v}"plain += self.app_secret return hashlib.md5(plain.encode()).hexdigest().upper() def search_items(self, keyword, page=1, min_price=0, max_price=9999): timestamp = str(int(time.time())) # 组装请求参数 params = { "method": "idle.item.search.get", "app_key": self.app_key, "access_token": self.access_token, "timestamp": timestamp, "format": "json", "v": "2.0","keyword": keyword, "page_no": page, "page_size": 20, "price_min": min_price, "price_max": max_price } # 生成签名 params["sign"] = self._make_sign(params) try: resp = self.session.post(API_URL, data=params, timeout=15) result =resp.json() # 错误判断 if result.get("code") != 0: return {"success": False, "msg": result.get("msg", "接口异常")} # 核心数据解析与清洗 items =result.get("data", {}).get("items", []) cleaned_items = [] for item in items: cleaned_items.append({ "商品ID": item.get("item_id"), "商品标题": item.get("title"), "售价": item.get("price"),"原价": item.get("original_price"), "商品成色": item.get("quality", "未知"), "是否包邮": "是" if item.get("free_shipping") else "否", "卖家信用": item.get("seller_credit", "未知"), "商品链接": f"https://go.idle.com/item?id={item.get('item_id')}"}) return { "success": True, "total": len(cleaned_items), "items": cleaned_items } except Exception as e: return {"success": False, "msg": f"请求异常：{str(e)}"} # 调用示例 if __name__ == "__main__": api = IdleItemSearchApi(APP_KEY, APP_SECRET, ACCESS_TOKEN) # 搜索：二手手机，价格500-2000元 res = api.search_items(keyword="二手手机", min_price=500, max_price=2000) if res["success"]: print(f"✅ 搜索成功，共{res['total']}个商品") for i, item in enumerate(res["items"][:5], 1):print(f"\n第{i}个：{item['商品标题']} | 售价：{item['售价']}") else: print(f"❌ {res['msg']}")