Goofish Visual Search (闲鱼 / Xianyu / Idlefish) | Search Listings by Image

Zen Studio China Scrapers   •  Goofish, JD.com, Taobao, and wholesale data
Goofish Visual ➤ You are here	Goofish Search Keyword search	Goofish Detail Full item detail	Sellers & Reviews Profiles + reviews	Taobao Products + reviews

Search Goofish (闲鱼 / Xianyu) — Alibaba's C2C second-hand marketplace — by image. Give it a product photo and get back the Goofish listings that visually match, each with 50+ fields: price, condition, image gallery, full description, seller profile with Zhima credit, shipping, category labels, and service guarantees.

This is the image-search sibling of the Goofish Search Scraper (keyword search). Same rich listing output — you just search with a picture instead of words.

What you can do with it

• Reverse image search — find every Goofish listing of a product from a single photo.
• Price a second-hand item — snap what you want to sell/buy and see the live spread of comparable listings.
• Sourcing & resale — discover matching inventory across sellers, filter by price, region, condition, and seller type.
• Brand / counterfeit monitoring — track how a product image circulates across the marketplace.

Input

Field	Description
Image URLs	One or more public image URLs to search by. Any hosting works — the actor prepares each image for the visual search automatically. Results from all images are merged and deduplicated by listing.
Image (base64)	Optional: a single image supplied inline as base64, instead of a URL.
Refine with keyword	Optional text combined with the image — return listings that look like the image and match this term (e.g. a brand or model).
Max items	How many matching listings to return per run (total across images). Default 100.
Detail level	Full (default): every matched listing is enriched with its complete detail page — description, every image, condition, specs, and full seller profile. Summary: the visual-match cards only (faster, fewer fields).
Filters	Sort (relevance / newest / price / credit), price range, published-within window, region (province or city), and quick filters (personal sellers, free shipping, brand new, inspection-verified, …).

Minimal input

{
  "imageUrls": ["https://example.com/my-product-photo.jpg"],
  "maxItems": 20
}

With filters

{
  "imageUrls": ["https://example.com/sneaker.jpg"],
  "picKeyword": "Nike",
  "maxItems": 50,
  "sortBy": "priceAsc",
  "priceMin": 100,
  "priceMax": 800,
  "regionIds": ["440300"],
  "quickFilters": ["filterPersonal", "filterFreePostage"]
}

Output

One row per visually-matched listing — the same rich schema as the Goofish Search Scraper — plus two image-search fields:

• queryImageUrl — the image this listing was matched against (trace which input produced which result).
• matchRank — the listing's rank in the visual match for that image (0 = closest match).

In the default Full mode every row carries the complete detail page: full description, the whole image gallery, condition, specs, category path, GPS coordinates, and the seller's profile with Zhima Sesame credit, reply/rating stats, and their other listings (50+ fields). Summary mode returns the visual-match card fields only — id, title, price, image gallery, location, seller, post time, and match rank — for faster, lighter runs.

Example row (Full mode; long arrays and text trimmed with …):

{
  "id": "1063561453507",
  "url": "https://www.goofish.com/item?id=1063561453507",
  "title": "双飞燕血手幽灵F100Q机械键盘，光轴，有线连接，红色背光，",
  "price": 60,
  "currency": "CNY",
  "city": "山东",
  "pictureUrl": "http://img.alicdn.com/bao/uploaded/i4/2222694157487/O1CN01Uo…",
  "images": [
    { "url": "http://img.alicdn.com/…/O1CN01Uo…", "width": "1080", "height": "608", "major": true, "type": "0", "photoSearchUrl": "https://h5.m.goofish.com/…" },
    { "url": "http://img.alicdn.com/…/O1CN01nx…", "width": "1080", "height": "608", "major": false, "type": "0", "photoSearchUrl": "https://h5.m.goofish.com/…" },
    "…+2 more"
  ],
  "listingType": "detailCommonBuy",
  "isAuction": true,
  "hasVideo": true,
  "isAd": true,
  "seller": {
    "name": "夏季主流",
    "avatarUrl": "https://img.alicdn.com/…",
    "refId": "+BVzL6VjA0IPhuLL9MeIwg==",
    "reviewsLabel": "0条评价",
    "stats": { "totalReviews": 0, "positiveRatePercent": 0, "totalItemsListed": 67, "totalSold": 22, "replyRate24h": "90%", "avgReplyInterval": "1小时", "avgReplyMinutes30d": 85 },
    "id": "2222694157487",
    "url": "https://www.goofish.com/personal?userId=2222694157487",
    "city": "济宁",
    "registeredAt": "2026-06-30T12:53:29+08:00",
    "registeredDays": "3",
    "zhimaVerified": true,
    "identityTags": ["实人认证未通过"],
    "yxpPro": false,
    "lastActiveLabel": "9分钟前来过",
    "summary": "卖出过22件宝贝。",
    "otherItems": [
      { "id": "1062451818008", "title": "iPad mini 2代 ，16GWiFi版，系统流畅不卡，", "priceLabel": "¥145", "imageUrl": "https://img.alicdn.com/…", "itemLink": "https://www.goofish.com/item?id=1062451818008", "type": "1" },
      "…+10 more (each with full attributes)"
    ]
  },
  "categoryId": "50025387",
  "taobaoCategoryId": "110210",
  "badges": ["18小时前发布"],
  "postedAt": "2026-07-02T23:03:21+08:00",
  "postedAtEpochMs": 1783004601000,
  "freeShipping": true,
  "categoryIds": { "catId": "50025387", "channelCatId": "126856263", "tbCatId": "110210", "leafId": "71" },
  "soldPrice": 60,
  "priceOriginal": 0,
  "description": "双飞燕血手幽灵F100Q机械键盘，光轴，有线连接，红色背光，104键，带大手托，按键灵敏，声音清脆，…",
  "status": "online",
  "statusLabel": "在线",
  "itemType": "detailCommonBuy",
  "quantity": 1,
  "shippingFee": "0.00",
  "stats": { "views": 9, "favorites": 0, "wants": 0, "sold": 0, "wantsUnit": "人想要" },
  "flags": { "simpleItem": true, "bargained": false, "charity": false, "tbSupportTrade": true, "pcSupportTrade": true },
  "specs": [
    { "name": "品牌", "value": "双飞燕", "propertyId": "20000", "valueId": "21991" },
    { "name": "型号", "value": "AT87", "propertyId": "473737100", "valueId": "66681306" },
    "…+4 more"
  ],
  "categoryName": "键盘",
  "categoryPath": ["键盘", "双飞燕", "…+5 more"],
  "categoryLabels": [ { "name": "分类", "value": "键盘", "channelCategoryId": "126856263" }, "…+6 more" ],
  "tags": ["包邮"],
  "descriptionRich": { "type": "RICH_TEXT", "children": "…structured description nodes…", "version": "1.0" },
  "serverTimeAt": "2026-07-03T17:59:15+08:00",
  "gpsRaw": "35.552765,116.776651",
  "gps": { "lat": 35.552765, "lng": 116.776651 },
  "regionAttributes": { "divisionId": "370882", "freeShipping": "1", "tbCatId": "50019780", "regionApprox": true },
  "condition": { "label": "轻微使用痕迹", "valueId": "1451890569" },
  "topics": ["双飞燕"],
  "detailStatus": "enriched",
  "queryImageUrl": "https://img.alicdn.com/bao/uploaded/i4/2142130636/O1CN0121L8…",
  "matchRank": 1
}

Pricing

Pay per result (pay-per-event): you are billed for each listing returned. Runs that find nothing cost only the base platform start fee. New users get a free tier to try the actor before committing budget.

Notes

• Results reflect live Goofish inventory and can vary run to run as sellers post and remove items.
• Best matches come from a clear, well-lit photo of a single product. Busy scenes or collages match poorly.
• The actor searches the same catalog as the Goofish app's own image search.

Related actors

Part of the Zen Studio China marketplace suite (Goofish, Taobao, JD.com, and wholesale).

More Zen Studio scrapers for Chinese platforms

🛒 E-commerce

• Shopee
  • Shopee Product Detail Scraper
  • Shopee Product Reviews Scraper
  • Shopee Product Scraper
• Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper
• Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
• JD.com 京东
  • JD.com Search Scraper
• 1688 阿里巴巴
  • 1688 Wholesale Scraper
  • 1688 Reviews Scraper
  • Alibaba Scraper
  • Alibaba Supplier Review Scraper
• Coupang 쿠팡
  • Coupang Review Scraper

🎬 Short-video & social

• Douyin 抖音
  • Douyin Search Scraper
  • Douyin Profile Scraper
  • Douyin Video Scraper
  • Douyin Comments Scraper
  • Douyin Transcripts Scraper
  • Douyin Creator Rankings Scraper
  • Douyin Live Recorder
  • Douyin Hot Search Scraper
  • Douyin Product Search Scraper
• RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Note Detail Scraper
  • RedNote Product Reviews Scraper
  • RedNote Live Recorder
• Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper
• Bilibili 哔哩哔哩
  • Bilibili Video Scraper
  • Bilibili Danmaku Scraper

🏠 Real estate & autos

• Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 58.com 58同城
  • 58.com Real Estate Scraper
• Autohome 汽车之家
  • Autohome (Che168) Used-Car Scraper