{
  "openapi": "3.0.1",
  "info": {
    "title": "Goofish Xianyu Scraper: Listings, Prices, Sellers",
    "description": "Scrape Goofish (Xianyu, 闲鱼) listings by item link, seller, similar items or channel feed: price, original price, want count, condition, seller nickname and city, publish time, pictures. No login. Keyword search is not offered: Goofish answers it with a login or slider check.",
    "version": "0.1",
    "x-build-id": "4ueKpWEfxRYZXlYwq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~goofish-xianyu-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-goofish-xianyu-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/themineworks~goofish-xianyu-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-goofish-xianyu-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/themineworks~goofish-xianyu-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-goofish-xianyu-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": {
          "itemUrls": {
            "title": "Item links or IDs",
            "type": "array",
            "description": "Goofish listing links or ids, one per line. A link such as https://www.goofish.com/item?id=1089872772258 or the number 1089872772258 gives one full row. Up to 200 per run; every item is delivered once.",
            "items": {
              "type": "string"
            }
          },
          "sellerUrls": {
            "title": "Seller links or IDs",
            "type": "array",
            "description": "Seller profile links or ids, one per line, such as https://www.goofish.com/personal?userId=47656566 or the number 47656566. The seller's listings are read, 20 per page. Goofish serves at most 50 pages, so 1,000 listings per seller is the most. Up to 200 sellers.",
            "items": {
              "type": "string"
            }
          },
          "similarTo": {
            "title": "Find listings similar to these items",
            "type": "array",
            "description": "One example listing per line, as a link or an id. Goofish's own 'similar items' list is read for each one, 30 per page, about 300 listings in total. This is the way to collect many listings of one kind of product without keyword search: find one example on goofish.com, paste it here. The example itself is not returned.",
            "items": {
              "type": "string"
            }
          },
          "channels": {
            "title": "Home and channel feeds",
            "type": "array",
            "description": "Goofish's own front-page feeds, 20 to 30 listings per page: the home feed, wardrobe bargains, anime and games, phones and digital, vouchers and cards. Each feed holds 240 to 320 different listings.",
            "items": {
              "type": "string",
              "enum": [
                "home",
                "wardrobe",
                "acg",
                "digital",
                "vouchers"
              ],
              "enumTitles": [
                "Home feed",
                "Wardrobe bargains (衣橱捡漏)",
                "Anime and games (二次元)",
                "Phones and digital (手机数码)",
                "Vouchers and cards (省钱卡券)"
              ]
            }
          },
          "maxItems": {
            "title": "Max listings per source",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "The most listings to return for each seller, each example item and each channel, 1 to 2,000. Goofish's own limits come first: 1,000 per seller, about 300 per example item or channel. Item links are not limited by this. Listings your filters drop do not count. Example: 100.",
            "default": 50
          },
          "includeDetails": {
            "title": "Open each listing (description, all pictures, original price, publish time, seller)",
            "type": "boolean",
            "description": "On: every listing found by a seller, similar or channel read is opened too, for the description, all pictures, original price, exact publish time, view and save counts, condition, attributes and the seller block. Off: rows come from the list cards only (title, price, want count, city, main picture, tags), which is faster. Item links are always opened. Same price either way.",
            "default": true
          },
          "includeSellerProfile": {
            "title": "Add the full seller nickname and profile",
            "type": "boolean",
            "description": "On: one light extra request per seller adds the full nickname (the listing itself shows only a masked form such as 我***旧), province, followers and shop level. Off: the masked nickname only.",
            "default": true
          },
          "minPrice": {
            "title": "Min price (CNY)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only listings asking at least this many yuan. Leave empty for no limit."
          },
          "maxPrice": {
            "title": "Max price (CNY)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only listings asking at most this many yuan. Leave empty for no limit."
          },
          "publishedWithinDays": {
            "title": "Posted within the last N days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Keep only listings posted in the last N days. Leave empty for any age."
          },
          "titleContains": {
            "title": "Title must contain one of these words",
            "type": "array",
            "description": "Keep only listings whose title contains at least one of these words, one per line, Chinese or English, not case sensitive. Example: iPhone 15, 苹果. Leave empty to keep all.",
            "items": {
              "type": "string"
            }
          },
          "freeShippingOnly": {
            "title": "Free shipping only",
            "type": "boolean",
            "description": "Keep only listings that ship free (包邮).",
            "default": false
          },
          "sortBy": {
            "title": "Sort each source's listings",
            "enum": [
              "source",
              "newest",
              "priceAsc",
              "priceDesc",
              "mostWanted"
            ],
            "type": "string",
            "description": "Orders the listings of each seller, example item and channel before they are delivered. Goofish order keeps the order the site returned them in and delivers rows as they are read; the other orders hold a source's rows until it is complete.",
            "default": "source"
          },
          "proxyMode": {
            "title": "Proxy",
            "enum": [
              "residential",
              "datacenter"
            ],
            "type": "string",
            "description": "Residential proxy (default) is the reliable choice: Goofish refuses an IP after a few dozen item calls, and residential IPs rotate from a large pool. Datacenter proxy is cheaper but its small shared pool is often refused, so use it only for a quick small test.",
            "default": "residential"
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}