# Goofish Xianyu Reverse Image Search Scraper 闲鱼 (`zen-studio/goofish-xianyu-visual-search-scraper`) Actor

Search Goofish (闲鱼 / Xianyu) by image. Provide a product photo, get visually-matching second-hand listings with price, condition, image gallery, seller profile, Zhima credit, category, and post time. Filter by price, region, and seller type. Summary or full detail. Export to JSON/CSV.

- **URL**: https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.99 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

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

![Goofish Visual Search Scraper](https://iili.io/CYmYZle.png)

<table style="width:100%">
<tr>
<td colspan="5" style="padding:10px 14px;background:#4C945E;border:none;border-radius:4px 4px 0 0">
<span style="color:#FAFAF9;font-size:14px;font-weight:700;letter-spacing:0.5px">Zen Studio China Scrapers</span>
<span style="color:#D7F4DD;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Goofish, JD.com, Taobao, and wholesale data</span>
</td>
</tr>
<tr>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;border-right:none;border-top:none;background:#E8F5E9;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper" style="color:#4C945E;text-decoration:none;font-weight:700;font-size:13px">Goofish Visual</a></span><br>
<span style="color:#4C945E;font-size:11px;font-weight:600">&#10148; You are here</span>
</td>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/goofish-xianyu-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Goofish Search</a></span><br>
<span style="color:#78716C;font-size:11px">Keyword search</span>
</td>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1vbpDShUjMFGaGcta-1fcx609tQN-goofish-search-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Goofish Detail</a></span><br>
<span style="color:#78716C;font-size:11px">Full item detail</span>
</td>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-2EHa8oEwBE1sDJaGb-tVMa2WLtpP-goofish-search-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/goofish-xianyu-seller-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Sellers &amp; Reviews</a></span><br>
<span style="color:#78716C;font-size:11px">Profiles + reviews</span>
</td>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;border-top:none;vertical-align:top;width:20%">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/taobao-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Taobao</a></span><br>
<span style="color:#78716C;font-size:11px">Products + reviews</span>
</td>
</tr>
</table>

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](https://apify.com/zen-studio/goofish-xianyu-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

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

#### With filters

```json
{
  "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](https://apify.com/zen-studio/goofish-xianyu-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 `…`):

```json
{
  "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**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-LwARSYSMWLBZfXfdr-FrDaNbQarB-shopee-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Shopee**
  - [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper)
  - [Shopee Product Reviews Scraper](https://apify.com/zen-studio/shopee-product-reviews-scraper)
  - [Shopee Product Scraper](https://apify.com/zen-studio/shopee-product-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)
  - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper)
  - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD.com 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
  - [1688 Reviews Scraper](https://apify.com/zen-studio/1688-reviews-scraper)
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
  - [Alibaba Supplier Review Scraper](https://apify.com/zen-studio/alibaba-supplier-review-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Coupang 쿠팡**
  - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper)

**🎬 Short-video & social**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
  - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
  - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper)
  - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper)
  - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper)
  - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-oSxuPDE1h3HAsHZSu-x3uV98mgTe-bilibili-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Bilibili 哔哩哔哩**
  - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper)
  - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper)

# Actor input Schema

## `imageUrls` (type: `array`):

One or more image URLs to search by. The actor returns Goofish (闲鱼 / Xianyu) listings that <b>visually match</b> each image.<br><br>Any public image URL works — the actor hosts it for the visual search automatically. Results from all images are merged and deduplicated by listing.<br><br>💡 A clear, well-lit photo of a single product gives the best matches.

## `imageFile` (type: `string`):

Upload a photo from your computer — or paste a single image URL — to search Goofish by that picture. The easiest way to search by your own image: no hosting needed.<br><br>For multiple images or automation, use <b>Image URLs</b> above.

## `imageBase64` (type: `string`):

Optional: a single image supplied inline as a base64-encoded string, instead of a URL. Use this when you have raw image bytes rather than a hosted link. If both this and <b>Image URLs</b> are set, both are searched.

## `picKeyword` (type: `string`):

Optional text combined with the image search — return listings that look like the image <b>and</b> match this term (e.g. a brand or model). Leave blank to search by image alone.

## `maxItems` (type: `integer`):

How many matching listings to return per run, in total across all input images.<br><br>Start with a small number (e.g. <code>20</code>) to preview the output shape before committing budget.

## `detailLevel` (type: `string`):

<b>Full</b> (default): every visually-matched listing is enriched with its complete detail page — full description, all images, condition, and seller profile/stats.<br><br><b>Summary</b>: returns the core fields from the visual-match results only — id, title, price, listing URL, post time, location, seller name, image gallery, and match rank — and runs <b>much faster</b> because it doesn't open each listing's detail page. Pick <b>Summary</b> when you just need the matching listings quickly; pick <b>Full</b> when you need descriptions, every image, or seller details.

## `regionIds` (type: `array`):

Restrict results to specific Chinese administrative regions. Pick a <b>province</b> for broad coverage (e.g. <code>Guangdong 广东</code>) or a specific <b>city</b> for tighter scope (e.g. <code>Shenzhen 深圳</code>). Select multiple to stack as OR.<br><br>Leave empty to search nationwide.

## `sortBy` (type: `string`):

How Goofish should order the returned listings before the <b>Max items</b> cap applies.

## `priceMin` (type: `integer`):

Include only listings priced at or above this amount, in Chinese yuan (¥).<br><br>Leave blank for no lower bound.

## `priceMax` (type: `integer`):

Include only listings priced at or below this amount, in Chinese yuan (¥).<br><br>Leave blank for no upper bound.

## `publishedWithinDays` (type: `string`):

Restrict to listings posted within this rolling window. By default this returns the listings Goofish 闲鱼 shows for the selected window — fast, and matching what you see on the website.<br><br>⚠️ <b>Note:</b> Goofish's web UI labels many items as recent ("N小时前发布") even when they're weeks or months old. To exclude those, enable <b>Verified recent only</b> below (slower, fewer results). For low-volume keywords, widen to <b>3天内</b> or <b>7天内</b> if results feel sparse.

## `verifiedRecentOnly` (type: `boolean`):

Off by default: returns the listings Goofish 闲鱼 shows for your <b>Published within</b> window — fast, and matching what you see on the website.<br><br>Turn on to additionally drop listings whose real posting time is older than the window (Goofish often labels older items as recent). More precise, but slower and returns fewer results. Only affects runs that set <b>Published within</b>.

## `quickFilters` (type: `array`):

Goofish 闲鱼's one-click filters. Select multiple to stack them.<br><br>• <b>个人闲置 Personal sellers only</b> — excludes shops/stores<br>• <b>验货宝 Inspection verified</b> — items checked by Xianyu<br>• <b>包邮 Free shipping</b> — no postage charge<br>• <b>全新 Brand new</b> — never used<br>• <b>严选 Xianyu-inspected phone</b> — phones verified by Xianyu

## Actor input object example

```json
{
  "imageUrls": [
    "https://img.alicdn.com/bao/uploaded/i4/2142130636/O1CN0121L8cW1GZL1fsvaiS_!!4611686018427384268-0-xy_item.jpg"
  ],
  "maxItems": 20,
  "detailLevel": "full",
  "sortBy": "newest",
  "publishedWithinDays": "",
  "verifiedRecentOnly": false
}
```

# Actor output Schema

## `listings` (type: `string`):

All visually-matched Goofish listings with full item + seller detail, plus the query image and match rank.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "imageUrls": [
        "https://img.alicdn.com/bao/uploaded/i4/2142130636/O1CN0121L8cW1GZL1fsvaiS_!!4611686018427384268-0-xy_item.jpg"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/goofish-xianyu-visual-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "imageUrls": ["https://img.alicdn.com/bao/uploaded/i4/2142130636/O1CN0121L8cW1GZL1fsvaiS_!!4611686018427384268-0-xy_item.jpg"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/goofish-xianyu-visual-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "imageUrls": [
    "https://img.alicdn.com/bao/uploaded/i4/2142130636/O1CN0121L8cW1GZL1fsvaiS_!!4611686018427384268-0-xy_item.jpg"
  ],
  "maxItems": 20
}' |
apify call zen-studio/goofish-xianyu-visual-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zen-studio/goofish-xianyu-visual-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Goofish Xianyu Reverse Image Search Scraper 闲鱼",
        "description": "Search Goofish (闲鱼 / Xianyu) by image. Provide a product photo, get visually-matching second-hand listings with price, condition, image gallery, seller profile, Zhima credit, category, and post time. Filter by price, region, and seller type. Summary or full detail. Export to JSON/CSV.",
        "version": "0.0",
        "x-build-id": "ydAnKX6uGR34e9hi3"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zen-studio~goofish-xianyu-visual-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zen-studio-goofish-xianyu-visual-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/zen-studio~goofish-xianyu-visual-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-zen-studio-goofish-xianyu-visual-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/zen-studio~goofish-xianyu-visual-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-zen-studio-goofish-xianyu-visual-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "imageUrls": {
                        "title": "🖼 Image URLs / 图片链接",
                        "type": "array",
                        "description": "One or more image URLs to search by. The actor returns Goofish (闲鱼 / Xianyu) listings that <b>visually match</b> each image.<br><br>Any public image URL works — the actor hosts it for the visual search automatically. Results from all images are merged and deduplicated by listing.<br><br>💡 A clear, well-lit photo of a single product gives the best matches.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "imageFile": {
                        "title": "📤 Upload an image / 上传图片 (optional)",
                        "type": "string",
                        "description": "Upload a photo from your computer — or paste a single image URL — to search Goofish by that picture. The easiest way to search by your own image: no hosting needed.<br><br>For multiple images or automation, use <b>Image URLs</b> above."
                    },
                    "imageBase64": {
                        "title": "Image (base64) / 图片 (base64, optional)",
                        "type": "string",
                        "description": "Optional: a single image supplied inline as a base64-encoded string, instead of a URL. Use this when you have raw image bytes rather than a hosted link. If both this and <b>Image URLs</b> are set, both are searched."
                    },
                    "picKeyword": {
                        "title": "Refine with keyword / 关键词细化 (optional)",
                        "type": "string",
                        "description": "Optional text combined with the image search — return listings that look like the image <b>and</b> match this term (e.g. a brand or model). Leave blank to search by image alone."
                    },
                    "maxItems": {
                        "title": "Max items / 最大数量",
                        "minimum": 1,
                        "maximum": 1500,
                        "type": "integer",
                        "description": "How many matching listings to return per run, in total across all input images.<br><br>Start with a small number (e.g. <code>20</code>) to preview the output shape before committing budget.",
                        "default": 100
                    },
                    "detailLevel": {
                        "title": "Detail level / 详情级别",
                        "enum": [
                            "full",
                            "summary"
                        ],
                        "type": "string",
                        "description": "<b>Full</b> (default): every visually-matched listing is enriched with its complete detail page — full description, all images, condition, and seller profile/stats.<br><br><b>Summary</b>: returns the core fields from the visual-match results only — id, title, price, listing URL, post time, location, seller name, image gallery, and match rank — and runs <b>much faster</b> because it doesn't open each listing's detail page. Pick <b>Summary</b> when you just need the matching listings quickly; pick <b>Full</b> when you need descriptions, every image, or seller details.",
                        "default": "full"
                    },
                    "regionIds": {
                        "title": "Region / 地区",
                        "type": "array",
                        "description": "Restrict results to specific Chinese administrative regions. Pick a <b>province</b> for broad coverage (e.g. <code>Guangdong 广东</code>) or a specific <b>city</b> for tighter scope (e.g. <code>Shenzhen 深圳</code>). Select multiple to stack as OR.<br><br>Leave empty to search nationwide.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "110000",
                                "110100",
                                "120000",
                                "120100",
                                "130000",
                                "130100",
                                "130200",
                                "130300",
                                "130400",
                                "130500",
                                "130600",
                                "130700",
                                "130800",
                                "130900",
                                "131000",
                                "131100",
                                "140000",
                                "140100",
                                "140200",
                                "140300",
                                "140400",
                                "140500",
                                "140600",
                                "140700",
                                "140800",
                                "140900",
                                "141000",
                                "141100",
                                "150000",
                                "150100",
                                "150200",
                                "150300",
                                "150400",
                                "150500",
                                "150600",
                                "150700",
                                "150800",
                                "150900",
                                "152200",
                                "152500",
                                "152900",
                                "210000",
                                "210100",
                                "210200",
                                "210300",
                                "210400",
                                "210500",
                                "210600",
                                "210700",
                                "210800",
                                "210900",
                                "211000",
                                "211100",
                                "211200",
                                "211300",
                                "211400",
                                "220000",
                                "220100",
                                "220200",
                                "220300",
                                "220400",
                                "220500",
                                "220600",
                                "220700",
                                "220800",
                                "222400",
                                "230000",
                                "230100",
                                "230200",
                                "230300",
                                "230400",
                                "230500",
                                "230600",
                                "230700",
                                "230800",
                                "230900",
                                "231000",
                                "231100",
                                "231200",
                                "232700",
                                "310000",
                                "310100",
                                "320000",
                                "320100",
                                "320200",
                                "320300",
                                "320400",
                                "320500",
                                "320600",
                                "320700",
                                "320800",
                                "320900",
                                "321000",
                                "321100",
                                "321200",
                                "321300",
                                "330000",
                                "330100",
                                "330200",
                                "330300",
                                "330400",
                                "330500",
                                "330600",
                                "330700",
                                "330800",
                                "330900",
                                "331000",
                                "331100",
                                "340000",
                                "340100",
                                "340200",
                                "340300",
                                "340400",
                                "340500",
                                "340600",
                                "340700",
                                "340800",
                                "341000",
                                "341100",
                                "341200",
                                "341300",
                                "341500",
                                "341600",
                                "341700",
                                "341800",
                                "350000",
                                "350100",
                                "350200",
                                "350300",
                                "350400",
                                "350500",
                                "350600",
                                "350700",
                                "350800",
                                "350900",
                                "360000",
                                "360100",
                                "360200",
                                "360300",
                                "360400",
                                "360500",
                                "360600",
                                "360700",
                                "360800",
                                "360900",
                                "361000",
                                "361100",
                                "370000",
                                "370100",
                                "370200",
                                "370300",
                                "370400",
                                "370500",
                                "370600",
                                "370700",
                                "370800",
                                "370900",
                                "371000",
                                "371100",
                                "371300",
                                "371400",
                                "371500",
                                "371600",
                                "371700",
                                "410000",
                                "410100",
                                "410200",
                                "410300",
                                "410400",
                                "410500",
                                "410600",
                                "410700",
                                "410800",
                                "410900",
                                "411000",
                                "411100",
                                "411200",
                                "411300",
                                "411400",
                                "411500",
                                "411600",
                                "411700",
                                "419001",
                                "420000",
                                "420100",
                                "420200",
                                "420300",
                                "420500",
                                "420600",
                                "420700",
                                "420800",
                                "420900",
                                "421000",
                                "421100",
                                "421200",
                                "421300",
                                "422800",
                                "429004",
                                "429005",
                                "429006",
                                "429021",
                                "430000",
                                "430100",
                                "430200",
                                "430300",
                                "430400",
                                "430500",
                                "430600",
                                "430700",
                                "430800",
                                "430900",
                                "431000",
                                "431100",
                                "431200",
                                "431300",
                                "433100",
                                "440000",
                                "440100",
                                "440200",
                                "440300",
                                "440400",
                                "440500",
                                "440600",
                                "440700",
                                "440800",
                                "440900",
                                "441200",
                                "441300",
                                "441400",
                                "441500",
                                "441600",
                                "441700",
                                "441800",
                                "441900",
                                "442000",
                                "445100",
                                "445200",
                                "445300",
                                "450000",
                                "450100",
                                "450200",
                                "450300",
                                "450400",
                                "450500",
                                "450600",
                                "450700",
                                "450800",
                                "450900",
                                "451000",
                                "451100",
                                "451200",
                                "451300",
                                "451400",
                                "460000",
                                "460100",
                                "460200",
                                "460300",
                                "460400",
                                "469001",
                                "469002",
                                "469005",
                                "469006",
                                "469007",
                                "469021",
                                "469022",
                                "469023",
                                "469024",
                                "469025",
                                "469026",
                                "469027",
                                "469028",
                                "469029",
                                "469030",
                                "500000",
                                "500100",
                                "510000",
                                "510100",
                                "510300",
                                "510400",
                                "510500",
                                "510600",
                                "510700",
                                "510800",
                                "510900",
                                "511000",
                                "511100",
                                "511300",
                                "511400",
                                "511500",
                                "511600",
                                "511700",
                                "511800",
                                "511900",
                                "512000",
                                "513200",
                                "513300",
                                "513400",
                                "520000",
                                "520100",
                                "520200",
                                "520300",
                                "520400",
                                "520500",
                                "520600",
                                "522300",
                                "522600",
                                "522700",
                                "530000",
                                "530100",
                                "530300",
                                "530400",
                                "530500",
                                "530600",
                                "530700",
                                "530800",
                                "530900",
                                "532300",
                                "532500",
                                "532600",
                                "532800",
                                "532900",
                                "533100",
                                "533300",
                                "533400",
                                "540000",
                                "540100",
                                "540200",
                                "540300",
                                "540400",
                                "540500",
                                "540600",
                                "542500",
                                "610000",
                                "610100",
                                "610200",
                                "610300",
                                "610400",
                                "610500",
                                "610600",
                                "610700",
                                "610800",
                                "610900",
                                "611000",
                                "620000",
                                "620100",
                                "620200",
                                "620300",
                                "620400",
                                "620500",
                                "620600",
                                "620700",
                                "620800",
                                "620900",
                                "621000",
                                "621100",
                                "621200",
                                "622900",
                                "623000",
                                "630000",
                                "630100",
                                "630200",
                                "632200",
                                "632300",
                                "632500",
                                "632600",
                                "632700",
                                "632800",
                                "640000",
                                "640100",
                                "640200",
                                "640300",
                                "640400",
                                "640500",
                                "650000",
                                "650100",
                                "650200",
                                "650400",
                                "650500",
                                "652300",
                                "652700",
                                "652800",
                                "652900",
                                "653000",
                                "653100",
                                "653200",
                                "654000",
                                "654200",
                                "654300",
                                "659001",
                                "659002",
                                "659003",
                                "659004",
                                "659005",
                                "659006",
                                "659007",
                                "659008",
                                "659009",
                                "659010",
                                "659011",
                                "710000",
                                "710100",
                                "710200",
                                "710300",
                                "710400",
                                "710500",
                                "710600",
                                "710700",
                                "710800",
                                "710900",
                                "711100",
                                "711200",
                                "711300",
                                "711400",
                                "711500",
                                "711700",
                                "711900",
                                "712100",
                                "712400",
                                "712500",
                                "712600",
                                "712700",
                                "712800",
                                "810000",
                                "810100",
                                "820000",
                                "820100"
                            ],
                            "enumTitles": [
                                "北京 Beijing (Province)",
                                "北京 Beijing · City",
                                "天津 Tianjin (Province)",
                                "天津 Tianjin · City",
                                "河北 Hebei (Province)",
                                "石家庄 · 河北 Hebei",
                                "唐山 · 河北 Hebei",
                                "秦皇岛 · 河北 Hebei",
                                "邯郸 · 河北 Hebei",
                                "邢台 · 河北 Hebei",
                                "保定 · 河北 Hebei",
                                "张家口 · 河北 Hebei",
                                "承德 · 河北 Hebei",
                                "沧州 · 河北 Hebei",
                                "廊坊 · 河北 Hebei",
                                "衡水 · 河北 Hebei",
                                "山西 Shanxi (Province)",
                                "太原 · 山西 Shanxi",
                                "大同 · 山西 Shanxi",
                                "阳泉 · 山西 Shanxi",
                                "长治 · 山西 Shanxi",
                                "晋城 · 山西 Shanxi",
                                "朔州 · 山西 Shanxi",
                                "晋中 · 山西 Shanxi",
                                "运城 · 山西 Shanxi",
                                "忻州 · 山西 Shanxi",
                                "临汾 · 山西 Shanxi",
                                "吕梁 · 山西 Shanxi",
                                "内蒙古 Inner Mongolia (Province)",
                                "呼和浩特 · 内蒙古 Inner Mongolia",
                                "包头 · 内蒙古 Inner Mongolia",
                                "乌海 · 内蒙古 Inner Mongolia",
                                "赤峰 · 内蒙古 Inner Mongolia",
                                "通辽 · 内蒙古 Inner Mongolia",
                                "鄂尔多斯 · 内蒙古 Inner Mongolia",
                                "呼伦贝尔 · 内蒙古 Inner Mongolia",
                                "巴彦淖尔 · 内蒙古 Inner Mongolia",
                                "乌兰察布 · 内蒙古 Inner Mongolia",
                                "兴安 · 内蒙古 Inner Mongolia",
                                "锡林郭勒 · 内蒙古 Inner Mongolia",
                                "阿拉善 · 内蒙古 Inner Mongolia",
                                "辽宁 Liaoning (Province)",
                                "沈阳 · 辽宁 Liaoning",
                                "大连 · 辽宁 Liaoning",
                                "鞍山 · 辽宁 Liaoning",
                                "抚顺 · 辽宁 Liaoning",
                                "本溪 · 辽宁 Liaoning",
                                "丹东 · 辽宁 Liaoning",
                                "锦州 · 辽宁 Liaoning",
                                "营口 · 辽宁 Liaoning",
                                "阜新 · 辽宁 Liaoning",
                                "辽阳 · 辽宁 Liaoning",
                                "盘锦 · 辽宁 Liaoning",
                                "铁岭 · 辽宁 Liaoning",
                                "朝阳 · 辽宁 Liaoning",
                                "葫芦岛 · 辽宁 Liaoning",
                                "吉林 Jilin (Province)",
                                "长春 · 吉林 Jilin",
                                "吉林 Jilin · City",
                                "四平 · 吉林 Jilin",
                                "辽源 · 吉林 Jilin",
                                "通化 · 吉林 Jilin",
                                "白山 · 吉林 Jilin",
                                "松原 · 吉林 Jilin",
                                "白城 · 吉林 Jilin",
                                "延边朝鲜族 · 吉林 Jilin",
                                "黑龙江 Heilongjiang (Province)",
                                "哈尔滨 · 黑龙江 Heilongjiang",
                                "齐齐哈尔 · 黑龙江 Heilongjiang",
                                "鸡西 · 黑龙江 Heilongjiang",
                                "鹤岗 · 黑龙江 Heilongjiang",
                                "双鸭山 · 黑龙江 Heilongjiang",
                                "大庆 · 黑龙江 Heilongjiang",
                                "伊春 · 黑龙江 Heilongjiang",
                                "佳木斯 · 黑龙江 Heilongjiang",
                                "七台河 · 黑龙江 Heilongjiang",
                                "牡丹江 · 黑龙江 Heilongjiang",
                                "黑河 · 黑龙江 Heilongjiang",
                                "绥化 · 黑龙江 Heilongjiang",
                                "大兴安岭 · 黑龙江 Heilongjiang",
                                "上海 Shanghai (Province)",
                                "上海 Shanghai · City",
                                "江苏 Jiangsu (Province)",
                                "南京 · 江苏 Jiangsu",
                                "无锡 · 江苏 Jiangsu",
                                "徐州 · 江苏 Jiangsu",
                                "常州 · 江苏 Jiangsu",
                                "苏州 · 江苏 Jiangsu",
                                "南通 · 江苏 Jiangsu",
                                "连云港 · 江苏 Jiangsu",
                                "淮安 · 江苏 Jiangsu",
                                "盐城 · 江苏 Jiangsu",
                                "扬州 · 江苏 Jiangsu",
                                "镇江 · 江苏 Jiangsu",
                                "泰州 · 江苏 Jiangsu",
                                "宿迁 · 江苏 Jiangsu",
                                "浙江 Zhejiang (Province)",
                                "杭州 · 浙江 Zhejiang",
                                "宁波 · 浙江 Zhejiang",
                                "温州 · 浙江 Zhejiang",
                                "嘉兴 · 浙江 Zhejiang",
                                "湖州 · 浙江 Zhejiang",
                                "绍兴 · 浙江 Zhejiang",
                                "金华 · 浙江 Zhejiang",
                                "衢州 · 浙江 Zhejiang",
                                "舟山 · 浙江 Zhejiang",
                                "台州 · 浙江 Zhejiang",
                                "丽水 · 浙江 Zhejiang",
                                "安徽 Anhui (Province)",
                                "合肥 · 安徽 Anhui",
                                "芜湖 · 安徽 Anhui",
                                "蚌埠 · 安徽 Anhui",
                                "淮南 · 安徽 Anhui",
                                "马鞍山 · 安徽 Anhui",
                                "淮北 · 安徽 Anhui",
                                "铜陵 · 安徽 Anhui",
                                "安庆 · 安徽 Anhui",
                                "黄山 · 安徽 Anhui",
                                "滁州 · 安徽 Anhui",
                                "阜阳 · 安徽 Anhui",
                                "宿州 · 安徽 Anhui",
                                "六安 · 安徽 Anhui",
                                "亳州 · 安徽 Anhui",
                                "池州 · 安徽 Anhui",
                                "宣城 · 安徽 Anhui",
                                "福建 Fujian (Province)",
                                "福州 · 福建 Fujian",
                                "厦门 · 福建 Fujian",
                                "莆田 · 福建 Fujian",
                                "三明 · 福建 Fujian",
                                "泉州 · 福建 Fujian",
                                "漳州 · 福建 Fujian",
                                "南平 · 福建 Fujian",
                                "龙岩 · 福建 Fujian",
                                "宁德 · 福建 Fujian",
                                "江西 Jiangxi (Province)",
                                "南昌 · 江西 Jiangxi",
                                "景德镇 · 江西 Jiangxi",
                                "萍乡 · 江西 Jiangxi",
                                "九江 · 江西 Jiangxi",
                                "新余 · 江西 Jiangxi",
                                "鹰潭 · 江西 Jiangxi",
                                "赣州 · 江西 Jiangxi",
                                "吉安 · 江西 Jiangxi",
                                "宜春 · 江西 Jiangxi",
                                "抚州 · 江西 Jiangxi",
                                "上饶 · 江西 Jiangxi",
                                "山东 Shandong (Province)",
                                "济南 · 山东 Shandong",
                                "青岛 · 山东 Shandong",
                                "淄博 · 山东 Shandong",
                                "枣庄 · 山东 Shandong",
                                "东营 · 山东 Shandong",
                                "烟台 · 山东 Shandong",
                                "潍坊 · 山东 Shandong",
                                "济宁 · 山东 Shandong",
                                "泰安 · 山东 Shandong",
                                "威海 · 山东 Shandong",
                                "日照 · 山东 Shandong",
                                "临沂 · 山东 Shandong",
                                "德州 · 山东 Shandong",
                                "聊城 · 山东 Shandong",
                                "滨州 · 山东 Shandong",
                                "菏泽 · 山东 Shandong",
                                "河南 Henan (Province)",
                                "郑州 · 河南 Henan",
                                "开封 · 河南 Henan",
                                "洛阳 · 河南 Henan",
                                "平顶山 · 河南 Henan",
                                "安阳 · 河南 Henan",
                                "鹤壁 · 河南 Henan",
                                "新乡 · 河南 Henan",
                                "焦作 · 河南 Henan",
                                "濮阳 · 河南 Henan",
                                "许昌 · 河南 Henan",
                                "漯河 · 河南 Henan",
                                "三门峡 · 河南 Henan",
                                "南阳 · 河南 Henan",
                                "商丘 · 河南 Henan",
                                "信阳 · 河南 Henan",
                                "周口 · 河南 Henan",
                                "驻马店 · 河南 Henan",
                                "济源 · 河南 Henan",
                                "湖北 Hubei (Province)",
                                "武汉 · 湖北 Hubei",
                                "黄石 · 湖北 Hubei",
                                "十堰 · 湖北 Hubei",
                                "宜昌 · 湖北 Hubei",
                                "襄阳 · 湖北 Hubei",
                                "鄂州 · 湖北 Hubei",
                                "荆门 · 湖北 Hubei",
                                "孝感 · 湖北 Hubei",
                                "荆州 · 湖北 Hubei",
                                "黄冈 · 湖北 Hubei",
                                "咸宁 · 湖北 Hubei",
                                "随州 · 湖北 Hubei",
                                "恩施 · 湖北 Hubei",
                                "仙桃 · 湖北 Hubei",
                                "潜江 · 湖北 Hubei",
                                "天门 · 湖北 Hubei",
                                "神农架 · 湖北 Hubei",
                                "湖南 Hunan (Province)",
                                "长沙 · 湖南 Hunan",
                                "株洲 · 湖南 Hunan",
                                "湘潭 · 湖南 Hunan",
                                "衡阳 · 湖南 Hunan",
                                "邵阳 · 湖南 Hunan",
                                "岳阳 · 湖南 Hunan",
                                "常德 · 湖南 Hunan",
                                "张家界 · 湖南 Hunan",
                                "益阳 · 湖南 Hunan",
                                "郴州 · 湖南 Hunan",
                                "永州 · 湖南 Hunan",
                                "怀化 · 湖南 Hunan",
                                "娄底 · 湖南 Hunan",
                                "湘西 · 湖南 Hunan",
                                "广东 Guangdong (Province)",
                                "广州 · 广东 Guangdong",
                                "韶关 · 广东 Guangdong",
                                "深圳 · 广东 Guangdong",
                                "珠海 · 广东 Guangdong",
                                "汕头 · 广东 Guangdong",
                                "佛山 · 广东 Guangdong",
                                "江门 · 广东 Guangdong",
                                "湛江 · 广东 Guangdong",
                                "茂名 · 广东 Guangdong",
                                "肇庆 · 广东 Guangdong",
                                "惠州 · 广东 Guangdong",
                                "梅州 · 广东 Guangdong",
                                "汕尾 · 广东 Guangdong",
                                "河源 · 广东 Guangdong",
                                "阳江 · 广东 Guangdong",
                                "清远 · 广东 Guangdong",
                                "东莞 · 广东 Guangdong",
                                "中山 · 广东 Guangdong",
                                "潮州 · 广东 Guangdong",
                                "揭阳 · 广东 Guangdong",
                                "云浮 · 广东 Guangdong",
                                "广西 Guangxi (Province)",
                                "南宁 · 广西 Guangxi",
                                "柳州 · 广西 Guangxi",
                                "桂林 · 广西 Guangxi",
                                "梧州 · 广西 Guangxi",
                                "北海 · 广西 Guangxi",
                                "防城港 · 广西 Guangxi",
                                "钦州 · 广西 Guangxi",
                                "贵港 · 广西 Guangxi",
                                "玉林 · 广西 Guangxi",
                                "百色 · 广西 Guangxi",
                                "贺州 · 广西 Guangxi",
                                "河池 · 广西 Guangxi",
                                "来宾 · 广西 Guangxi",
                                "崇左 · 广西 Guangxi",
                                "海南 Hainan (Province)",
                                "海口 · 海南 Hainan",
                                "三亚 · 海南 Hainan",
                                "三沙 · 海南 Hainan",
                                "儋州 · 海南 Hainan",
                                "五指山 · 海南 Hainan",
                                "琼海 · 海南 Hainan",
                                "文昌 · 海南 Hainan",
                                "万宁 · 海南 Hainan",
                                "东方 · 海南 Hainan",
                                "定安 · 海南 Hainan",
                                "屯昌 · 海南 Hainan",
                                "澄迈 · 海南 Hainan",
                                "临高 · 海南 Hainan",
                                "白沙 · 海南 Hainan",
                                "昌江 · 海南 Hainan",
                                "乐东 · 海南 Hainan",
                                "陵水 · 海南 Hainan",
                                "保亭 · 海南 Hainan",
                                "琼中 · 海南 Hainan",
                                "重庆 Chongqing (Province)",
                                "重庆 Chongqing · City",
                                "四川 Sichuan (Province)",
                                "成都 · 四川 Sichuan",
                                "自贡 · 四川 Sichuan",
                                "攀枝花 · 四川 Sichuan",
                                "泸州 · 四川 Sichuan",
                                "德阳 · 四川 Sichuan",
                                "绵阳 · 四川 Sichuan",
                                "广元 · 四川 Sichuan",
                                "遂宁 · 四川 Sichuan",
                                "内江 · 四川 Sichuan",
                                "乐山 · 四川 Sichuan",
                                "南充 · 四川 Sichuan",
                                "眉山 · 四川 Sichuan",
                                "宜宾 · 四川 Sichuan",
                                "广安 · 四川 Sichuan",
                                "达州 · 四川 Sichuan",
                                "雅安 · 四川 Sichuan",
                                "巴中 · 四川 Sichuan",
                                "资阳 · 四川 Sichuan",
                                "阿坝 · 四川 Sichuan",
                                "甘孜 · 四川 Sichuan",
                                "凉山 · 四川 Sichuan",
                                "贵州 Guizhou (Province)",
                                "贵阳 · 贵州 Guizhou",
                                "六盘水 · 贵州 Guizhou",
                                "遵义 · 贵州 Guizhou",
                                "安顺 · 贵州 Guizhou",
                                "毕节 · 贵州 Guizhou",
                                "铜仁 · 贵州 Guizhou",
                                "黔西南 · 贵州 Guizhou",
                                "黔东南 · 贵州 Guizhou",
                                "黔南 · 贵州 Guizhou",
                                "云南 Yunnan (Province)",
                                "昆明 · 云南 Yunnan",
                                "曲靖 · 云南 Yunnan",
                                "玉溪 · 云南 Yunnan",
                                "保山 · 云南 Yunnan",
                                "昭通 · 云南 Yunnan",
                                "丽江 · 云南 Yunnan",
                                "普洱 · 云南 Yunnan",
                                "临沧 · 云南 Yunnan",
                                "楚雄 · 云南 Yunnan",
                                "红河 · 云南 Yunnan",
                                "文山 · 云南 Yunnan",
                                "西双版纳 · 云南 Yunnan",
                                "大理 · 云南 Yunnan",
                                "德宏 · 云南 Yunnan",
                                "怒江 · 云南 Yunnan",
                                "迪庆 · 云南 Yunnan",
                                "西藏 Xizang (Tibet) (Province)",
                                "拉萨 · 西藏 Xizang (Tibet)",
                                "日喀则 · 西藏 Xizang (Tibet)",
                                "昌都 · 西藏 Xizang (Tibet)",
                                "林芝 · 西藏 Xizang (Tibet)",
                                "山南 · 西藏 Xizang (Tibet)",
                                "那曲 · 西藏 Xizang (Tibet)",
                                "阿里 · 西藏 Xizang (Tibet)",
                                "陕西 Shaanxi (Province)",
                                "西安 · 陕西 Shaanxi",
                                "铜川 · 陕西 Shaanxi",
                                "宝鸡 · 陕西 Shaanxi",
                                "咸阳 · 陕西 Shaanxi",
                                "渭南 · 陕西 Shaanxi",
                                "延安 · 陕西 Shaanxi",
                                "汉中 · 陕西 Shaanxi",
                                "榆林 · 陕西 Shaanxi",
                                "安康 · 陕西 Shaanxi",
                                "商洛 · 陕西 Shaanxi",
                                "甘肃 Gansu (Province)",
                                "兰州 · 甘肃 Gansu",
                                "嘉峪关 · 甘肃 Gansu",
                                "金昌 · 甘肃 Gansu",
                                "白银 · 甘肃 Gansu",
                                "天水 · 甘肃 Gansu",
                                "武威 · 甘肃 Gansu",
                                "张掖 · 甘肃 Gansu",
                                "平凉 · 甘肃 Gansu",
                                "酒泉 · 甘肃 Gansu",
                                "庆阳 · 甘肃 Gansu",
                                "定西 · 甘肃 Gansu",
                                "陇南 · 甘肃 Gansu",
                                "临夏 · 甘肃 Gansu",
                                "甘南 · 甘肃 Gansu",
                                "青海 Qinghai (Province)",
                                "西宁 · 青海 Qinghai",
                                "海东 · 青海 Qinghai",
                                "海北 · 青海 Qinghai",
                                "黄南 · 青海 Qinghai",
                                "海南藏族 · 青海 Qinghai",
                                "果洛 · 青海 Qinghai",
                                "玉树 · 青海 Qinghai",
                                "海西 · 青海 Qinghai",
                                "宁夏 Ningxia (Province)",
                                "银川 · 宁夏 Ningxia",
                                "石嘴山 · 宁夏 Ningxia",
                                "吴忠 · 宁夏 Ningxia",
                                "固原 · 宁夏 Ningxia",
                                "中卫 · 宁夏 Ningxia",
                                "新疆 Xinjiang (Province)",
                                "乌鲁木齐 · 新疆 Xinjiang",
                                "克拉玛依 · 新疆 Xinjiang",
                                "吐鲁番 · 新疆 Xinjiang",
                                "哈密 · 新疆 Xinjiang",
                                "昌吉 · 新疆 Xinjiang",
                                "博尔塔拉 · 新疆 Xinjiang",
                                "巴音郭楞 · 新疆 Xinjiang",
                                "阿克苏 · 新疆 Xinjiang",
                                "克孜勒苏柯尔克孜 · 新疆 Xinjiang",
                                "喀什 · 新疆 Xinjiang",
                                "和田 · 新疆 Xinjiang",
                                "伊犁 · 新疆 Xinjiang",
                                "塔城 · 新疆 Xinjiang",
                                "阿勒泰 · 新疆 Xinjiang",
                                "石河子 · 新疆 Xinjiang",
                                "阿拉尔 · 新疆 Xinjiang",
                                "图木舒克 · 新疆 Xinjiang",
                                "五家渠 · 新疆 Xinjiang",
                                "北屯 · 新疆 Xinjiang",
                                "铁门关 · 新疆 Xinjiang",
                                "双河 · 新疆 Xinjiang",
                                "可克达拉 · 新疆 Xinjiang",
                                "昆玉 · 新疆 Xinjiang",
                                "胡杨河 · 新疆 Xinjiang",
                                "新星 · 新疆 Xinjiang",
                                "台湾 Taiwan (Province)",
                                "台北 · 台湾 Taiwan",
                                "高雄 · 台湾 Taiwan",
                                "台南 · 台湾 Taiwan",
                                "台中 · 台湾 Taiwan",
                                "金门 · 台湾 Taiwan",
                                "南投 · 台湾 Taiwan",
                                "基隆 · 台湾 Taiwan",
                                "新竹 · 台湾 Taiwan",
                                "嘉义 · 台湾 Taiwan",
                                "新北 · 台湾 Taiwan",
                                "宜兰 · 台湾 Taiwan",
                                "新竹 · 台湾 Taiwan",
                                "桃园 · 台湾 Taiwan",
                                "苗栗 · 台湾 Taiwan",
                                "彰化 · 台湾 Taiwan",
                                "嘉义 · 台湾 Taiwan",
                                "云林 · 台湾 Taiwan",
                                "屏东 · 台湾 Taiwan",
                                "台东 · 台湾 Taiwan",
                                "花莲 · 台湾 Taiwan",
                                "澎湖 · 台湾 Taiwan",
                                "连江 · 台湾 Taiwan",
                                "香港 Hong Kong (Province)",
                                "香港 Hong Kong · City",
                                "澳门 Macau (Province)",
                                "澳门 Macau · City"
                            ]
                        }
                    },
                    "sortBy": {
                        "title": "Sort by / 排序方式",
                        "enum": [
                            "relevance",
                            "newest",
                            "priceAsc",
                            "priceDesc",
                            "priceDrop",
                            "modified",
                            "credit"
                        ],
                        "type": "string",
                        "description": "How Goofish should order the returned listings before the <b>Max items</b> cap applies.",
                        "default": "newest"
                    },
                    "priceMin": {
                        "title": "Min price / 最低价格 (CNY ¥)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Include only listings priced at or above this amount, in Chinese yuan (¥).<br><br>Leave blank for no lower bound."
                    },
                    "priceMax": {
                        "title": "Max price / 最高价格 (CNY ¥)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Include only listings priced at or below this amount, in Chinese yuan (¥).<br><br>Leave blank for no upper bound."
                    },
                    "publishedWithinDays": {
                        "title": "Published within / 发布时间",
                        "enum": [
                            "",
                            "1",
                            "3",
                            "7",
                            "14"
                        ],
                        "type": "string",
                        "description": "Restrict to listings posted within this rolling window. By default this returns the listings Goofish 闲鱼 shows for the selected window — fast, and matching what you see on the website.<br><br>⚠️ <b>Note:</b> Goofish's web UI labels many items as recent (\"N小时前发布\") even when they're weeks or months old. To exclude those, enable <b>Verified recent only</b> below (slower, fewer results). For low-volume keywords, widen to <b>3天内</b> or <b>7天内</b> if results feel sparse.",
                        "default": ""
                    },
                    "verifiedRecentOnly": {
                        "title": "Verified recent only / 仅显示真实最新",
                        "type": "boolean",
                        "description": "Off by default: returns the listings Goofish 闲鱼 shows for your <b>Published within</b> window — fast, and matching what you see on the website.<br><br>Turn on to additionally drop listings whose real posting time is older than the window (Goofish often labels older items as recent). More precise, but slower and returns fewer results. Only affects runs that set <b>Published within</b>.",
                        "default": false
                    },
                    "quickFilters": {
                        "title": "Quick filters / 快速筛选",
                        "type": "array",
                        "description": "Goofish 闲鱼's one-click filters. Select multiple to stack them.<br><br>• <b>个人闲置 Personal sellers only</b> — excludes shops/stores<br>• <b>验货宝 Inspection verified</b> — items checked by Xianyu<br>• <b>包邮 Free shipping</b> — no postage charge<br>• <b>全新 Brand new</b> — never used<br>• <b>严选 Xianyu-inspected phone</b> — phones verified by Xianyu",
                        "items": {
                            "type": "string",
                            "enum": [
                                "filterPersonal",
                                "filterAppraise",
                                "gameAccountInsurance",
                                "filterFreePostage",
                                "filterHighLevelYxpSeller",
                                "filterNew",
                                "inspectedPhone",
                                "filterOneKeyResell"
                            ],
                            "enumTitles": [
                                "个人闲置 (Personal sellers only)",
                                "验货宝 (Inspection verified)",
                                "验号担保 (Game account guarantee)",
                                "包邮 (Free shipping)",
                                "超赞鱼小铺 (Top shop)",
                                "全新 (Brand new)",
                                "严选 (Xianyu-inspected phone)",
                                "转卖 (One-click resell)"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```