# Get new items and price drops from a Xianyu shop

**Use case:** 

Watches a Xianyu (Goofish) seller's shop with a watch list. The first run returns the shop, up to 240 items. Every later run with the same watch list name returns only items that are new, items whose price or title changed (with the old value), and items that are gone. Run it on a schedule, for example every morning.

## Input

```json
{
  "sellers": [
    "https://www.goofish.com/personal?userId=2214156880408"
  ],
  "maxItemsPerSeller": 240,
  "includeSimilar": false,
  "scrapeDetails": false,
  "maxConcurrency": 10,
  "watchName": "xianyu shop watch"
}
```

## Output

```json
{
  "change": {
    "label": "Change",
    "format": "text"
  },
  "type": {
    "label": "Row",
    "format": "text"
  },
  "item_id": {
    "label": "Item id",
    "format": "text"
  },
  "seller_id": {
    "label": "Seller id",
    "format": "text"
  },
  "title": {
    "label": "Title",
    "format": "text"
  },
  "price": {
    "label": "Price, CNY",
    "format": "number"
  },
  "changed_fields": {
    "label": "Changed",
    "format": "array"
  },
  "previous": {
    "label": "Before",
    "format": "object"
  },
  "source_seller_id": {
    "label": "Listed by",
    "format": "text"
  },
  "url": {
    "label": "Link",
    "format": "link"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Xianyu (Goofish) Item & Seller Scraper Actor is ready to run with the inputs already set for "Get new items and price drops from a Xianyu shop". [Sign up or log in](https://console.apify.com/create-task-from-example/UfcvRosQPHpbucDEX) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Get new items and price drops from a Xianyu shop" task

The Xianyu (Goofish) Item & Seller Scraper Actor will start running based on the input automatically. You can also change all the input fields, like seller links or ids, items per seller, and more, to match your specific use case.

### 3. Receive the "Get new items and price drops from a Xianyu shop" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as change, row, item id, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Get new items and price drops from a Xianyu shop" task via API](https://apify.com/maksim_lazouski/xianyu-goofish-item-seller-scraper.md).

## FAQ

### What does the Xianyu shop watch task return on later runs?

The Xianyu shop watch task returns only what changed since the last run with the same watch list name: new items, price or title changes with the old value, and items that are gone.

### How do I run it every day?

Save the Xianyu shop watch task in your Apify account and add a schedule, for example every morning. Keep the watch list name the same; use another name for another list.

### Are unchanged or gone items charged?

No. In the Xianyu shop watch task unchanged items are not stored or charged, and rows for items that are gone are free. You pay for new and changed items.

## About this Actor

This example demonstrates how to use [Xianyu (Goofish) Item & Seller Scraper](https://apify.com/maksim_lazouski/xianyu-goofish-item-seller-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/maksim_lazouski/xianyu-goofish-item-seller-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/maksim_lazouski/xianyu-goofish-item-seller-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).