闲鱼的收藏品和交易卡 API API

API ID 15004

提取实时Goofish和闲鱼中国二手市场的CNY列表,英文和中文关键词搜索,降价提醒,完整的产品状态规格,照片图库,卖家信用档案,活跃和已售库存目录,以及经过验证的买家评论

API 文档

端点

请求
通过英语或中文关键词、价格范围、最近价格下降、卖家信用和发货城市或省份搜索实时的Goofish和闲鱼二手市场 Listings 以CNY 计价
Endpoint ID: 39543
GET https://zylalabs.com/api/15004/collectibles+and+trading+cards+api+for+xianyu/39543/search+secondhand+marketplace+listings
输入参数

搜索二手市场列表 — 端点功能

对象 描述
keyword 必需 Product search query in English or Chinese.
page 可选 Page number starting at 1 for paginated search results.
page_size 可选 Number of listings returned per page between 1 and 30.
sort_by 可选 Sort mode: newest, priceDrop, priceAsc, priceDesc, credit, popularity, relevance, or modified.
region 可选 Optional dispatch city or province name such as shenzhen, shanghai, guangzhou, or hangzhou.
price_min 可选 Minimum asking price filter in CNY.
price_max 可选 Maximum asking price filter in CNY.
personal_only 可选 Set to true to filter for individual personal sellers excluding commercial merchants.
free_shipping 可选 Set to true to filter for listings with free domestic shipping included.
brand_new 可选 Set to true to filter for unused items in brand-new condition.
inspected_only 可选 Set to true to filter for platform-inspected authenticated listings.
publish_days 可选 Filter listings published within the last 1, 3, 7, or 14 days.

剩余免费测试请求:3 / 3。


输入参数

keyword
page
page_size
sort_by
region
price_min
price_max
personal_only
free_shipping
brand_new
inspected_only
publish_days
API 示例响应
JSON
{
    "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/15004/collectibles+and+trading+cards+api+for+xianyu/39543/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' 


    
请求
检索完整的Goofish和闲鱼列表详情,包括完整的卖家描述、磨损和状况等级、结构化规格、照片库、互动指标和卖家信用
Endpoint ID: 39544
GET https://zylalabs.com/api/15004/collectibles+and+trading+cards+api+for+xianyu/39544/get+listing+detail+and+condition+specs
输入参数

获取列表详细信息和状态规格 — 端点功能

对象 描述
item_id 必需 Numeric 8 to 18 digit listing identifier.
url 可选 Optional full listing link instead of item_id.

剩余免费测试请求:3 / 3。


输入参数

item_id
url
API 示例响应
JSON
{
    "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/15004/collectibles+and+trading+cards+api+for+xianyu/39544/get+listing+detail+and+condition+specs?item_id=1098494659099' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
在单个请求中并行丰富最多5个Goofish和闲鱼的列表标识符,包含完整描述、结构化条件规格、照片库和卖家信誉指标
Endpoint ID: 39545
GET https://zylalabs.com/api/15004/collectibles+and+trading+cards+api+for+xianyu/39545/batch+lookup+multiple+listings
输入参数

批量查找多个列表 — 端点功能

对象 描述
item_ids 必需 Comma-separated list of 2 to 5 numeric listing identifiers.

剩余免费测试请求:3 / 3。


输入参数

item_ids
API 示例响应
JSON
{
    "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/15004/collectibles+and+trading+cards+api+for+xianyu/39545/batch+lookup+multiple+listings?item_ids=1098494659099,1100537849655' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
提取全面的Goofish和闲鱼卖家个人资料指标,包括信用评级、身份验证徽章、粉丝数量、活跃商品数量、总销售数量和聊天响应率
Endpoint ID: 39546
GET https://zylalabs.com/api/15004/collectibles+and+trading+cards+api+for+xianyu/39546/get+seller+profile+and+credit+score
输入参数

获取卖家资料和信用评分 — 端点功能

对象 描述
seller_id 必需 Numeric seller user identifier or encrypted seller handle.
include_items 可选 Set to true to embed the first page of seller storefront listings.
include_reviews 可选 Set to true to embed the first page of buyer transaction reviews.
max_items 可选 Maximum number of embedded storefront items between 1 and 20 when include_items is true.
max_reviews 可选 Maximum number of embedded buyer reviews between 1 and 20 when include_reviews is true.

剩余免费测试请求:3 / 3。


输入参数

seller_id
include_items
include_reviews
max_items
max_reviews
API 示例响应
JSON
{
    "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/15004/collectibles+and+trading+cards+api+for+xianyu/39546/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' 


    
请求
按列表状态对所有商品进行分页的Goofish和Xianyu卖家店铺目录,服务器端过滤,活跃的在售库存或已完成的历史售出列表
Endpoint ID: 39547
GET https://zylalabs.com/api/15004/collectibles+and+trading+cards+api+for+xianyu/39547/get+seller+active+and+sold+inventory
输入参数

获取卖家活跃和已售库存 — 端点功能

对象 描述
seller_id 必需 Numeric seller user identifier or encrypted seller handle.
status 可选 Inventory status filter: all, onsale for active stock, or sold for completed historical sales.
page 可选 Catalog page number starting at 1.
page_size 可选 Number of catalog listings per page between 1 and 20.

剩余免费测试请求:3 / 3。


输入参数

seller_id
status
page
page_size
API 示例响应
JSON
{
    "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/15004/collectibles+and+trading+cards+api+for+xianyu/39547/get+seller+active+and+sold+inventory?seller_id=214347285&status=all&page=1&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
为Goofish和Xianyu卖家分页验证买家交易反馈,并提供服务器端过滤器以查看所有评论、带开箱照片的评论、正面评价或负面评价
Endpoint ID: 39548
GET https://zylalabs.com/api/15004/collectibles+and+trading+cards+api+for+xianyu/39548/get+seller+buyer+reviews+and+ratings
输入参数

获取卖家买家评价和评分 — 端点功能

对象 描述
seller_id 必需 Numeric seller user identifier or encrypted seller handle.
filter 可选 Review filter mode: all, with_photos, positive_only, or negative_only.
page 可选 Review page number starting at 1.
page_size 可选 Number of buyer reviews per page between 1 and 20.

剩余免费测试请求:3 / 3。


输入参数

seller_id
filter
page
page_size
API 示例响应
JSON
{
    "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/15004/collectibles+and+trading+cards+api+for+xianyu/39548/get+seller+buyer+reviews+and+ratings?seller_id=214347285&filter=all&page=1&page_size=10' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 闲鱼的收藏品和交易卡 API API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

提取实时的Goofish和闲鱼中国二手市场的CNY列表,英文和中文关键词搜索,降价提醒,完整的状态规格,照片库,卖家信用档案,活跃和已售库存目录,以及经过验证的买家评论

闲鱼的收藏品和交易卡 API API FAQs

是的 搜索二手市场列表端点支持中文和英文查询 自动将225个常见的英文品牌 摄像头型号和产品类别映射为本地中文搜索词 同时保留型号

不 六个端点都可以在不需要用户账户 cookies 或移动应用会话的情况下操作

将sort_by设置为priceDrop或credit在搜索端点,并结合personal_only、free_shipping或inspected_only过滤器以隔离经过验证的个人交易

是的 使用获取卖家档案和信用评分来验证徽章和累计销售数量 并调用获取卖家活动和已出售库存 状态设置为已售出以检索完成的历史列表

所有列表价格 原始零售价格 和节省金额均以人民币(CNY)作为数值返回

在搜索端点的区域参数中传递一个英语或中文的城市或省份名称,例如深圳 上海 广州 杭州 或者 北京

每个端点返回与二手市场列表相关的结构化数据,包括物品详情、卖家档案、库存状态和买家评论。例如,搜索端点提供物品标题、价格和卖家评级,而卖家档案端点包括信用评分和验证徽章

关键字段包括 `id`、`title`、`description`、`price`、`currency`、`sellerId` 和 `sellerCreditRating` 例如,获取商品详情的接口返回详细的商品描述和卖家指标,而卖家评价接口提供反馈数量和评分

参数因端点而异。对于搜索端点,您可以使用“关键字”、“价格范围”、“卖家信用”和“地区”。获取卖家活跃和已售库存端点允许按“状态”(活跃或已售)和分页参数如“页”和“页大小”进行过滤

响应数据被组织成一个`meta`部分,其中包括请求详情,以及一个`data`部分,包含相关信息。例如,搜索端点中的`data`部分包含一个`items`数组,每个元素都有自己的属性,如`title`、`price`和`url`

每个端点提供特定的信息:搜索端点提供商品列表,获取商品详情端点提供全面的商品描述,卖家档案端点包括卖家指标,卖家评价端点提供买家反馈

用户可以通过指定搜索参数,如“关键词”、“价格范围”和“地区”,或选择“状态”和卖家库存的分页选项来定制请求。这使得根据用户需求提供量身定制的结果

典型的使用案例包括二手商品的市场分析 跟踪价格趋势 评估卖家的可靠性以及比较产品的状况 例如 用户可能会搜索特定商品的近期降价或在购买前评估卖家的信誉

数据准确性通过从Goofish和闲鱼市场实时提取得以保持,确保列表反映当前的可用性和状况。此外,卖家资料包括验证徽章和信用评级,增强了提供数据的可信度

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]