闲鱼二手市场数据API API

API ID 14971

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

100% 正常运行时间 4,518 ms 平均响应

API 文档

端点

请求
通过英文或中文关键词、价格范围、最近降价、卖家信誉以及发货城市或省份在CNY中搜索实时的Goofish和闲鱼二手市场列表
Endpoint ID: 39319
GET https://zylalabs.com/api/14971/secondhand+marketplace+data+api+for+xianyu/39319/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/14971/secondhand+marketplace+data+api+for+xianyu/39319/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和Xianyu列表详情,包括完整的卖家描述,磨损和条件等级,结构化规格,照片库,互动指标和卖家信用
Endpoint ID: 39320
GET https://zylalabs.com/api/14971/secondhand+marketplace+data+api+for+xianyu/39320/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/14971/secondhand+marketplace+data+api+for+xianyu/39320/get+listing+detail+and+condition+specs?item_id=1098494659099' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
在单个请求中同时丰富多达5个Goofish和Xianyu列表标识符,包含完整描述、结构化条件规格、照片库和卖家信任指标
Endpoint ID: 39321
GET https://zylalabs.com/api/14971/secondhand+marketplace+data+api+for+xianyu/39321/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/14971/secondhand+marketplace+data+api+for+xianyu/39321/batch+lookup+multiple+listings?item_ids=1098494659099,1100537849655' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
提取全面的Goofish和Xianyu卖家档案指标,包括信用评分、身份验证徽章、粉丝数量、活跃商品数量、总销量和聊天响应率
Endpoint ID: 39322
GET https://zylalabs.com/api/14971/secondhand+marketplace+data+api+for+xianyu/39322/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/14971/secondhand+marketplace+data+api+for+xianyu/39322/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: 39323
GET https://zylalabs.com/api/14971/secondhand+marketplace+data+api+for+xianyu/39323/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/14971/secondhand+marketplace+data+api+for+xianyu/39323/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: 39324
GET https://zylalabs.com/api/14971/secondhand+marketplace+data+api+for+xianyu/39324/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/14971/secondhand+marketplace+data+api+for+xianyu/39324/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和闲鱼中国二手市场列表以人民币为单位支持英语和中文关键词搜索价格下降提醒完整的状态规格照片库卖家信用档案活跃和已售库存目录以及经过验证的买家评论

闲鱼二手市场数据API API FAQs

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

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

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

是的 使用获取卖家资料和信用评分进行验证徽章和累计销售计数 并调用获取卖家活跃和已售库存状态设置为已售以检索已完成的历史列表

所有上市价格 原始零售价格 和节省金额均以人民币(CNY)的数值形式返回

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

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

关键字段包括“id”(列表标识符)、“title”(商品名称)、“price”(当前价格)、“sellerCredit”(卖家评级)和“description”(商品详情)。每个端点都有与其功能相关的特定字段,如搜索端点中的“items”和卖家评论端点中的“reviews”

参数因端点而异对于搜索端点您可以使用“关键字”“价格范围”“卖家信用”和“区域”卖家库存端点允许按“状态”(活跃或已售出)进行过滤每个端点的文档指定了可接受的参数以进行自定义

响应数据以JSON格式组织,其中包含“成功”标志、“元”信息(如请求ID和延迟)以及包含相关细节的“数据”对象。例如,搜索端点的“数据”包括“项目”、“计数”和分页详细信息

数据来源于中国的Goofish和闲鱼二手市场 实时提取的列表确保信息反映当前的可用性和卖家信誉 有助于维护数据准确性

如果搜索没有结果,“count”字段将为零,“hasMore”将为假。用户可以通过调整关键词或过滤器等参数来改进结果以优化查询。对于批量查找,请检查“failedItemIds”字段以获取任何未成功的请求

典型的用例包括市场分析、价格比较和卖家评估。开发者可以使用API构建应用程序来跟踪价格趋势、评估卖家可靠性或向用户提供所需商品价格下跌的警报

用户可以利用结构化数据创建用户友好的界面,展示商品详情,并可视化卖家评级。例如,整合“pictureUrl”用于图片和“profileUrl”用于卖家资料,可以增强用户在市场上的参与感和信任感

一般常见问题

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]