{
"success": true,
"meta": {
"request_id": "req_gf_b78e74ef78",
"plugin": "goofish",
"endpoint": "search",
"tier": "PRO",
"cached": false,
"latency_ms": 5792.5,
"timestamp": "2026-11-14T23:56:25.577240+00:00"
},
"data": {
"keyword": "iPhone 15",
"resolvedKeyword": "iPhone 15",
"page": 1,
"pageSize": 12,
"count": 1,
"hasMore": true,
"genuineZeroResults": false,
"sortBy": "newest",
"filters": [],
"items": [
{
"recordType": "item",
"id": "1101303196234",
"title": "Apple/苹果 iPhone 15 256GB 中国大陆版 蓝色 下方真机照片就是本机,只要在上架的就是有货;机器详情请点击本页面顶部价格下的验货报告 【型号】 苹果 iPhone 15 【机身颜色】 蓝色 【机身内存】 256G 【来源渠道】 国行 【关于电池】 原厂电池 【电池效率】 85%-90% 【退货周期】 7天 【发货时间】 付款后24小时内发货 【关于售后】 保修一年,支持7天无理由退货 【温馨提醒】 为了提供更好的购物体验,给予用户更多的选择,请您下单后30分钟内进行支付,超时未支付系统会自动关闭订单。如有需求可以再次选择喜欢的商品下单哦~",
"description": null,
"price": 2749,
"originalPrice": 3129,
"discountRate": "-12.1%",
"savingsAmount": 380,
"currency": "CNY",
"url": "https://www.goofish.com/item?id=1101303196234",
"appDeepLink": "fleamarket://awesome_detail?itemId=1101303196234",
"pictureUrl": "https://img.alicdn.com/bao/uploaded/i4/O1CN01PMUB12SXHcE5HIiO_!!4611686018427382419-0-fleamarket.jpg",
"imageUrls": [
"https://img.alicdn.com/bao/uploaded/i4/O1CN01PMUB12SXHcE5HIiO_!!4611686018427382419-0-fleamarket.jpg"
],
"imageDimensions": null,
"hasVideo": false,
"videoUrl": null,
"city": "四川",
"itemCity": null,
"condition": "良好",
"status": "onsale",
"freeShipping": true,
"allowBargain": null,
"tradeGuarantee": null,
"isFresh": null,
"auctionType": null,
"wants": 0,
"stats": null,
"tags": [
"6小时前发布",
"¥3129",
"严选"
],
"specs": [],
"category": "50025386",
"categoryId": "50025386",
"categoryPath": [],
"sellerId": "2210663101589",
"sellerNick": "seller_138e",
"displayName": "seller_138e",
"sellerCredit": null,
"seller": {
"id": "2210663101589",
"name": "seller_138e",
"url": "https://www.goofish.com/personal?userId=2210663101589",
"encryptedId": "6oeNSLh7VmMZmD4Thpl/6Q==",
"city": "四川",
"zhimaCredit": null,
"creditRating": null,
"zhimaAuth": null,
"goodReviewRate": "38%",
"totalSold": null,
"replyRate24h": null,
"averageReplyTime": null,
"registrationDays": null,
"lastActive": null,
"signature": null,
"isProSeller": null,
"avatarUrl": "https://img.alicdn.com/imgextra/i3/O1CN01goofish_avatar_placeholder.png"
},
"searchQuery": "iPhone 15",
"postedAt": "2026-11-14T17:35:45+00:00",
"scrapedAt": "2026-11-14T23:56:25.575393+00:00",
"detailLevel": "summary"
}
]
}
}
curl --location --request GET 'https://zylalabs.com/api/14976/secondhand+collectibles+and+trading+cards+data+api/39349/search+secondhand+marketplace+listings?keyword=Sony A7 Mark IV&page=1&page_size=10&sort_by=newest®ion=shenzhen&personal_only=false&free_shipping=false&brand_new=false&inspected_only=false' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_gf_246449678e",
"plugin": "goofish",
"endpoint": "item",
"tier": "PRO",
"cached": false,
"latency_ms": 1875.46,
"timestamp": "2026-11-14T23:56:29.338353+00:00"
},
"data": {
"recordType": "item",
"id": "1101303196234",
"title": "Apple/苹果 iPhone 15 256GB 中国大陆版 蓝色",
"description": "Apple/苹果 iPhone 15 256GB 中国大陆版 蓝色",
"price": 2749,
"originalPrice": null,
"discountRate": null,
"savingsAmount": null,
"currency": "CNY",
"url": "https://www.goofish.com/item?id=1101303196234",
"appDeepLink": "fleamarket://awesome_detail?itemId=1101303196234",
"pictureUrl": "https://img.alicdn.com/bao/uploaded/i4/O1CN01PMUB12SXHcE5HIiO_!!4611686018427382419-0-fleamarket.jpg",
"imageUrls": [
"https://img.alicdn.com/bao/uploaded/i4/O1CN01PMUB12SXHcE5HIiO_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01RhYfXGCWLID5HIiO_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i4/O1CN012b6ZHpgar6B54aQA_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01MfYxzQxr26G54aQA_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN016suM85iJCJK54aQA_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i2/O1CN01l3AYxUZJglI54aQA_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01wKytdmFWQoD54aQA_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i4/O1CN01JVx9cllrDEF54aQA_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i4/O1CN01h1rD9GUuT9B54aQA_!!4611686018427382419-0-fleamarket.jpg"
],
"imageDimensions": null,
"hasVideo": false,
"videoUrl": null,
"city": null,
"itemCity": null,
"condition": "良好",
"status": "onsale",
"freeShipping": false,
"allowBargain": false,
"tradeGuarantee": false,
"isFresh": null,
"auctionType": null,
"wants": 0,
"stats": {
"views": 0,
"wants": 0,
"favorites": 0
},
"tags": [],
"specs": {
"成色": "良好"
},
"category": null,
"categoryId": null,
"categoryPath": [],
"sellerId": "2210884182798",
"sellerNick": "seller_5de9",
"displayName": "seller_5de9",
"sellerCredit": null,
"seller": {
"id": "2210884182798",
"name": "seller_5de9",
"url": "https://www.goofish.com/personal?userId=2210884182798",
"encryptedId": null,
"city": null,
"zhimaCredit": null,
"creditRating": null,
"zhimaAuth": null,
"goodReviewRate": null,
"totalSold": null,
"replyRate24h": null,
"averageReplyTime": null,
"registrationDays": 0,
"lastActive": null,
"signature": null,
"isProSeller": null,
"avatarUrl": null
},
"searchQuery": null,
"postedAt": null,
"scrapedAt": "2026-11-14T23:56:29.337950+00:00",
"detailLevel": "full"
}
}
curl --location --request GET 'https://zylalabs.com/api/14976/secondhand+collectibles+and+trading+cards+data+api/39350/get+listing+detail+and+condition+specs?item_id=1098494659099' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_gf_265c47c5a7",
"plugin": "goofish",
"endpoint": "items-batch",
"tier": "PRO",
"cached": false,
"latency_ms": 3869.88,
"timestamp": "2026-11-14T23:56:33.211308+00:00"
},
"data": {
"requestedCount": 2,
"returnedCount": 2,
"failedItemIds": [],
"items": [
{
"recordType": "item",
"id": "1101303196234",
"title": "Apple/苹果 iPhone 15 256GB 中国大陆版 蓝色",
"description": "Apple/苹果 iPhone 15 256GB 中国大陆版 蓝色",
"price": 2749,
"originalPrice": null,
"discountRate": null,
"savingsAmount": null,
"currency": "CNY",
"url": "https://www.goofish.com/item?id=1101303196234",
"appDeepLink": "fleamarket://awesome_detail?itemId=1101303196234",
"pictureUrl": "https://img.alicdn.com/bao/uploaded/i4/O1CN01PMUB12SXHcE5HIiO_!!4611686018427382419-0-fleamarket.jpg",
"imageUrls": [
"https://img.alicdn.com/bao/uploaded/i4/O1CN01PMUB12SXHcE5HIiO_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01RhYfXGCWLID5HIiO_!!4611686018427382419-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i4/O1CN012b6ZHpgar6B54aQA_!!4611686018427382419-0-fleamarket.jpg"
],
"imageDimensions": null,
"hasVideo": false,
"videoUrl": null,
"city": null,
"itemCity": null,
"condition": "良好",
"status": "onsale",
"freeShipping": false,
"allowBargain": false,
"tradeGuarantee": false,
"isFresh": null,
"auctionType": null,
"wants": 0,
"stats": {
"views": 0,
"wants": 0,
"favorites": 0
},
"tags": [],
"specs": {
"成色": "良好"
},
"category": null,
"categoryId": null,
"categoryPath": [],
"sellerId": "2210884182798",
"sellerNick": "seller_5de9",
"displayName": "seller_5de9",
"sellerCredit": null,
"seller": {
"id": "2210884182798",
"name": "seller_5de9",
"url": "https://www.goofish.com/personal?userId=2210884182798",
"encryptedId": null,
"city": null,
"zhimaCredit": null,
"creditRating": null,
"zhimaAuth": null,
"goodReviewRate": null,
"totalSold": null,
"replyRate24h": null,
"averageReplyTime": null,
"registrationDays": 0,
"lastActive": null,
"signature": null,
"isProSeller": null,
"avatarUrl": null
},
"searchQuery": null,
"postedAt": null,
"scrapedAt": "2026-11-14T23:56:29.914128+00:00",
"detailLevel": "full"
},
{
"recordType": "item",
"id": "1098155927882",
"title": "Apple/苹果 iPhone 15 256GB 中国大陆版 粉色",
"description": "Apple/苹果 iPhone 15 256GB 中国大陆版 粉色",
"price": 2509,
"originalPrice": null,
"discountRate": null,
"savingsAmount": null,
"currency": "CNY",
"url": "https://www.goofish.com/item?id=1098155927882",
"appDeepLink": "fleamarket://awesome_detail?itemId=1098155927882",
"pictureUrl": "https://img.alicdn.com/bao/uploaded/i4/O1CN017fZUtYwGNpB5HIiO_!!4611686018427383053-0-fleamarket.jpg",
"imageUrls": [
"https://img.alicdn.com/bao/uploaded/i4/O1CN017fZUtYwGNpB5HIiO_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN0199Sy0xVDaUK5HIiO_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i2/O1CN01MVbNwANa8DF54aQA_!!4611686018427383053-0-fleamarket.jpg"
],
"imageDimensions": null,
"hasVideo": false,
"videoUrl": null,
"city": null,
"itemCity": null,
"condition": "良好",
"status": "onsale",
"freeShipping": false,
"allowBargain": false,
"tradeGuarantee": false,
"isFresh": null,
"auctionType": null,
"wants": 0,
"stats": {
"views": 0,
"wants": 0,
"favorites": 0
},
"tags": [],
"specs": {
"成色": "良好"
},
"category": null,
"categoryId": null,
"categoryPath": [],
"sellerId": "2210645102787",
"sellerNick": "seller_c4d4",
"displayName": "seller_c4d4",
"sellerCredit": null,
"seller": {
"id": "2210645102787",
"name": "seller_c4d4",
"url": "https://www.goofish.com/personal?userId=2210645102787",
"encryptedId": null,
"city": null,
"zhimaCredit": null,
"creditRating": null,
"zhimaAuth": null,
"goodReviewRate": null,
"totalSold": null,
"replyRate24h": null,
"averageReplyTime": null,
"registrationDays": 0,
"lastActive": null,
"signature": null,
"isProSeller": null,
"avatarUrl": null
},
"searchQuery": null,
"postedAt": null,
"scrapedAt": "2026-11-14T23:56:33.210895+00:00",
"detailLevel": "full"
}
]
}
}
curl --location --request GET 'https://zylalabs.com/api/14976/secondhand+collectibles+and+trading+cards+data+api/39351/batch+lookup+multiple+listings?item_ids=1098494659099,1100537849655' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_gf_ca61828f06",
"plugin": "goofish",
"endpoint": "seller",
"tier": "PRO",
"cached": false,
"latency_ms": 708.9,
"timestamp": "2026-11-14T23:56:35.325703+00:00"
},
"data": {
"sellerId": "2210645102787",
"nickname": "seller_106a",
"sellerNick": "seller_106a",
"displayName": "seller_106a",
"avatarUrl": "https://img.alicdn.com/imgextra/i3/O1CN01goofish_avatar_placeholder.png",
"location": "河北省",
"profileUrl": "https://www.goofish.com/personal?userId=2210645102787",
"sellerCredit": "卖家信用极好",
"zhimaCreditRating": "卖家信用极好",
"sellerCreditRating": "卖家信用极好",
"sellerCreditLevel": "5",
"sellerCreditIcon": "https://img.alicdn.com/imgextra/i4/O1CN01Cwu79sgwr6D0ShT2_!!6000000006982-2-tps-228-48.png",
"buyerCreditRating": "未知",
"buyerCreditLevel": null,
"buyerCreditIcon": null,
"isProSeller": false,
"verified": true,
"isRealNameVerified": true,
"isRealPersonVerified": true,
"isZhimaVerified": false,
"verificationBadges": [
"实名认证",
"实人认证",
"闲鱼升级用户"
],
"followerCount": 6343,
"followingCount": 0,
"totalActiveListings": 12041,
"totalReviews": 2348,
"totalSoldCount": 2348,
"responseRate": "N/A",
"registrationDays": null,
"items": null,
"reviews": null,
"reviewTabs": null
}
}
curl --location --request GET 'https://zylalabs.com/api/14976/secondhand+collectibles+and+trading+cards+data+api/39352/get+seller+profile+and+credit+score?seller_id=214347285&include_items=false&include_reviews=false&max_items=10&max_reviews=10' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_gf_bb98ffcfda",
"plugin": "goofish",
"endpoint": "seller-items",
"tier": "PRO",
"cached": false,
"latency_ms": 408.24,
"timestamp": "2026-11-14T23:56:35.738651+00:00"
},
"data": {
"sellerId": "2210645102787",
"page": 1,
"pageSize": 10,
"status": "onsale",
"count": 1,
"hasMore": true,
"groups": [
{
"groupId": "46145627",
"groupName": "全部",
"itemNumber": 12041
},
{
"groupId": "46145628",
"groupName": "在售",
"itemNumber": 4980
},
{
"groupId": "46145629",
"groupName": "已售出",
"itemNumber": 7061
}
],
"items": [
{
"recordType": "item",
"id": "1101210476041",
"title": "Apple/苹果 iPhone 15 Pro 256GB 中国大陆版 白色",
"description": null,
"price": 3719,
"originalPrice": null,
"discountRate": null,
"savingsAmount": null,
"currency": "CNY",
"url": "https://www.goofish.com/item?id=1101210476041",
"appDeepLink": "fleamarket://awesome_detail?itemId=1101210476041&flutter=true&detailPageType=detailB2CCommonBuy&needNotPreGet=true",
"pictureUrl": "https://img.alicdn.com/bao/uploaded/i1/O1CN01BWvzYEa7bjD5HIiO_!!4611686018427383053-0-fleamarket.jpg",
"imageUrls": [
"https://img.alicdn.com/bao/uploaded/i1/O1CN01BWvzYEa7bjD5HIiO_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i4/O1CN01bCqkrY9Ru4L5HIiO_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i2/O1CN01mJ4dr5IzkpL54aQA_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01Z64S8L2DeGE54aQA_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01fo66dSwIuBJ54aQA_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i4/O1CN01hfqRO4AwSlE54aQA_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i4/O1CN01SeFQvgCTeqC54aQA_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01maVFIOh5uXD54aQA_!!4611686018427383053-0-fleamarket.jpg",
"https://img.alicdn.com/bao/uploaded/i3/O1CN01IZRRI6coU1F54aQA_!!4611686018427383053-0-fleamarket.jpg"
],
"imageDimensions": {
"width": 2600,
"height": 2600
},
"hasVideo": false,
"videoUrl": null,
"city": null,
"itemCity": null,
"condition": "良好",
"status": "onsale",
"freeShipping": true,
"allowBargain": null,
"tradeGuarantee": null,
"isFresh": true,
"auctionType": "一口价",
"wants": 0,
"stats": null,
"tags": [
"包邮",
"24小时内发布",
"券已抵50元",
"7天无理由",
"bufubipei",
"严选"
],
"specs": [],
"category": "50025386",
"categoryId": "50025386",
"categoryPath": [],
"sellerId": "2210645102787",
"sellerNick": "seller_9c4e",
"displayName": "seller_9c4e",
"sellerCredit": null,
"seller": {
"id": "2210645102787",
"name": "seller_9c4e",
"url": "https://www.goofish.com/personal?userId=2210645102787",
"encryptedId": null,
"city": null,
"zhimaCredit": null,
"creditRating": null,
"zhimaAuth": null,
"goodReviewRate": null,
"totalSold": null,
"replyRate24h": null,
"averageReplyTime": null,
"registrationDays": null,
"lastActive": null,
"signature": null,
"isProSeller": true,
"avatarUrl": null
},
"searchQuery": null,
"postedAt": null,
"scrapedAt": "2026-11-14T23:56:35.736645+00:00",
"detailLevel": "summary"
}
]
}
}
curl --location --request GET 'https://zylalabs.com/api/14976/secondhand+collectibles+and+trading+cards+data+api/39353/get+seller+active+and+sold+inventory?seller_id=214347285&status=all&page=1&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY'
{
"success": true,
"meta": {
"request_id": "req_gf_bef47476c8",
"plugin": "goofish",
"endpoint": "seller-reviews",
"tier": "PRO",
"cached": false,
"latency_ms": 1310.96,
"timestamp": "2026-11-14T23:56:37.437258+00:00"
},
"data": {
"sellerId": "2210645102787",
"page": 1,
"pageSize": 10,
"filter": "all",
"count": 3,
"hasMore": true,
"reviewTabs": [
{
"name": "全部",
"count": null,
"rateType": 0,
"extraTag": null
},
{
"name": "有图",
"count": 259,
"rateType": 3,
"extraTag": null
},
{
"name": "好评",
"count": 2240,
"rateType": 1,
"extraTag": null
},
{
"name": "来自买家",
"count": 2348,
"rateType": 6,
"extraTag": null
},
{
"name": "描述真实",
"count": 137,
"rateType": 4,
"extraTag": "2088582075919030821"
},
{
"name": "发货快",
"count": 32,
"rateType": 4,
"extraTag": "4316742292262096070"
},
{
"name": "沟通愉快",
"count": 29,
"rateType": 4,
"extraTag": "2468865758646485510"
},
{
"name": "回复快",
"count": 19,
"rateType": 4,
"extraTag": "834603638124855156"
},
{
"name": "包装好",
"count": 10,
"rateType": 4,
"extraTag": "8393137417540770676"
},
{
"name": "耐心解答",
"count": 3,
"rateType": 4,
"extraTag": "2073861040402004297"
}
],
"reviews": [
{
"reviewId": "41372920398",
"buyerNick": "buyer_e3d7",
"raterAvatarUrl": "https://img.alicdn.com/imgextra/i3/O1CN01goofish_avatar_placeholder.png",
"raterRole": "buyer",
"ratingType": "negative",
"ratingRaw": -1,
"feedbackText": "显卡的灰很多,好歹深度清理一下再拿出来卖呀",
"feedbackDate": "2026-11-15T00:39:08Z",
"timeDesc": "7小时前",
"ipLocation": "中国北京市",
"reviewImages": [],
"tags": [
"买家"
],
"appendReview": null,
"sellerReply": null,
"tradedItem": {
"itemId": null,
"itemTitle": null,
"soldPrice": 0
},
"likesCount": 0,
"isHighQuality": false
},
{
"reviewId": "41364016052",
"buyerNick": "buyer_e3d7",
"raterAvatarUrl": "https://img.alicdn.com/imgextra/i3/O1CN01goofish_avatar_placeholder.png",
"raterRole": "buyer",
"ratingType": "positive",
"ratingRaw": 1,
"feedbackText": "好",
"feedbackDate": "2026-11-13T20:02:47Z",
"timeDesc": "1天前",
"ipLocation": "中国广东省",
"reviewImages": [],
"tags": [
"买家"
],
"appendReview": null,
"sellerReply": null,
"tradedItem": {
"itemId": null,
"itemTitle": null,
"soldPrice": 0
},
"likesCount": 0,
"isHighQuality": false
},
{
"reviewId": "41287735112",
"buyerNick": "buyer_e3d7",
"raterAvatarUrl": "https://img.alicdn.com/imgextra/i3/O1CN01goofish_avatar_placeholder.png",
"raterRole": "buyer",
"ratingType": "positive",
"ratingRaw": 1,
"feedbackText": "好评",
"feedbackDate": "2026-11-13T20:02:19Z",
"timeDesc": "1天前",
"ipLocation": "中国广东省",
"reviewImages": [],
"tags": [
"买家"
],
"appendReview": null,
"sellerReply": null,
"tradedItem": {
"itemId": null,
"itemTitle": null,
"soldPrice": 0
},
"likesCount": 0,
"isHighQuality": false
}
]
}
}
curl --location --request GET 'https://zylalabs.com/api/14976/secondhand+collectibles+and+trading+cards+data+api/39354/get+seller+buyer+reviews+and+ratings?seller_id=214347285&filter=all&page=1&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Secondhand Collectibles and Trading Cards Data API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
Extract secondhand collectibles, trading cards, figures, and vintage product listings in CNY across Goofish and Xianyu with English keyword search, item condition specs, and batch lookup.
Yes. The Search Secondhand Marketplace Listings endpoint supports both Chinese and English queries, automatically mapping 225 common English brands, camera models, and product categories into native Chinese search terms while preserving model numbers.
No. All six endpoints operate without requiring user accounts, cookies, or mobile app sessions.
Set sort_by to priceDrop or credit on the search endpoint, and combine personal_only, free_shipping, or inspected_only filters to isolate verified individual deals.
Yes. Use Get Seller Profile and Credit Score for verification badges and cumulative sales counts, and call Get Seller Active and Sold Inventory with status set to sold to retrieve completed historical listings.
All listing prices, original retail prices, and savings amounts are returned as numeric values in Chinese Yuan (CNY).
Pass an English or Chinese city or province name such as shenzhen, shanghai, guangzhou, hangzhou, or beijing in the region parameter on the search endpoint.
Each endpoint returns detailed information about secondhand collectibles and trading cards, including item listings, seller profiles, condition specifications, and buyer reviews. For example, the Search endpoint provides listing titles, prices, and seller ratings, while the Seller Profile endpoint offers metrics like credit ratings and active listings.
Key fields include `id`, `title`, `description`, `price`, `currency`, `sellerId`, `sellerCredit`, and `imageUrls`. These fields provide essential details about the items and sellers, enabling users to assess listings effectively.
Parameters vary by endpoint but generally include `keyword`, `price bounds`, `dispatch city`, `sortBy`, and filters like `personal_only` or `free_shipping`. These allow users to customize searches and refine results based on specific criteria.
Response data is structured in a JSON format, with a `meta` section for request details and a `data` section containing the relevant information. Each item is encapsulated in an array, making it easy to iterate through listings or seller details.
The API provides various information types, including item listings with descriptions and prices, seller profiles with credit scores, and buyer reviews. Each endpoint focuses on a specific aspect, ensuring comprehensive data coverage for users.
Users can leverage the returned data to compare listings, evaluate seller credibility, and make informed purchasing decisions. For instance, analyzing seller ratings and item conditions can help identify trustworthy sellers and quality products.
Data accuracy is maintained through real-time updates from Goofish and Xianyu marketplaces. The API aggregates listings directly from these platforms, ensuring that users receive the most current and reliable information available.
Typical use cases include market research for collectibles, price tracking for trading cards, and evaluating seller reliability. Users can also utilize the API for inventory management or to enhance e-commerce platforms with secondhand product listings.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund