{
  "openapi": "3.0.1",
  "info": {
    "title": "Goofish Xianyu Scraper - 闲鱼 Items, Sellers, Reviews, Comments",
    "description": "Scrape Goofish (闲鱼 Xianyu) items by link or ID and whole seller shops: price, condition, location, wants, views, photos, seller credit, reviews, comments, similar items. No login. Items $2.70 per 1,000; shop listings $0.45, seller profiles and reviews $0.90 per 1,000.",
    "version": "0.1",
    "x-build-id": "p0dexqxfp2PffQvsR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~xianyu-goofish-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-xianyu-goofish-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/topapi~xianyu-goofish-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-xianyu-goofish-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/topapi~xianyu-goofish-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-xianyu-goofish-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 item links (https://www.goofish.com/item?id=..., the mobile h5.m.goofish.com/item?id=... link) or bare item ids, one per line. Each one comes back as an item row with full details and the seller.",
            "items": {
              "type": "string"
            }
          },
          "sellerUrls": {
            "title": "🏪 Seller links or IDs",
            "type": "array",
            "description": "Goofish seller links (https://www.goofish.com/personal?userId=...) or bare user ids, one per line. Each seller gives a profile row and the listings of the shop. The seller id is in every item row as sellerId.",
            "items": {
              "type": "string"
            }
          },
          "maxListingsPerSeller": {
            "title": "Listings per seller",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "How many listings of each seller's shop to return (20 per page, in the shop's own order). 0 = the profile only. In monitor mode this is the window checked each run: the shop's first N listings.",
            "default": 20
          },
          "listingStatus": {
            "title": "Listing status",
            "enum": [
              "all",
              "onSale",
              "sold"
            ],
            "type": "string",
            "description": "Which listings of a shop to read (the shop's own 在售 / 已售出 tabs), and which item rows to keep.",
            "default": "all"
          },
          "listingDetails": {
            "title": "Full details for every shop listing",
            "type": "boolean",
            "description": "Open every listing of the shop and return it as a full item row (description, condition, location, posting time, views, saves, variants) instead of a listing card. Charged as an item.",
            "default": false
          },
          "maxItems": {
            "title": "Max items and listings",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many item and listing rows in total (seller profiles, reviews and comments are capped by their own settings).",
            "default": 200
          },
          "minPrice": {
            "title": "Min price (CNY)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only items and listings at or above this asking price, in yuan."
          },
          "maxPrice": {
            "title": "Max price (CNY)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only items and listings at or below this asking price, in yuan."
          },
          "publishedWithinDays": {
            "title": "Posted within (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Keep only items posted in the last N days. Applies to rows that carry a posting time (item rows, similar items, home feed); shop listing cards carry none unless \"Full details\" is on."
          },
          "minConditionLevel": {
            "title": "Min condition level",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Keep only item rows at or above this Goofish condition level (10 = 全新 brand new, 9, 8, 7...). Item rows only."
          },
          "freeShippingOnly": {
            "title": "Free shipping only",
            "type": "boolean",
            "description": "Keep only items and listings that show free shipping (包邮).",
            "default": false
          },
          "includeSellerProfile": {
            "title": "Seller profile rows",
            "type": "boolean",
            "description": "One profile row per seller link: display name, avatar, introduction, IP location, followers, listings on sale and sold, review count, praise ratio, shop level and score, credit label, real-name / Zhima verification.",
            "default": true
          },
          "includeItemSellerProfiles": {
            "title": "Seller profile rows for item links",
            "type": "boolean",
            "description": "Also return the profile row of each distinct seller of your item links (the item row already carries the main seller fields).",
            "default": false
          },
          "includeReviews": {
            "title": "Seller reviews",
            "type": "boolean",
            "description": "Reviews the seller received (信用及评价): rating, text, tags, reviewer nick and role, IP location, date, photos.",
            "default": false
          },
          "maxReviewsPerSeller": {
            "title": "Reviews per seller",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Newest first, 20 per page. In monitor mode this is the window checked each run: the newest N reviews.",
            "default": 20
          },
          "reviewFilter": {
            "title": "Which reviews",
            "enum": [
              "all",
              "positive",
              "negative",
              "withPhotos",
              "fromBuyers",
              "fromSellers"
            ],
            "type": "string",
            "description": "The seller page's own review tabs.",
            "default": "all"
          },
          "includeComments": {
            "title": "Item comments",
            "type": "boolean",
            "description": "Public comments (留言) under each of your item links, with the replies inline and whether the seller wrote it.",
            "default": false
          },
          "maxCommentsPerItem": {
            "title": "Comments per item",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Newest first.",
            "default": 20
          },
          "includeSimilar": {
            "title": "Similar items",
            "type": "boolean",
            "description": "The listings Goofish recommends under each of your item links (\"为你推荐\"), as listing rows: title, price, city, wants, posting time, seller nick, photo.",
            "default": false
          },
          "maxSimilarPerItem": {
            "title": "Similar items per item",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Up to 30.",
            "default": 10
          },
          "homeFeedPages": {
            "title": "Home feed pages",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Also read N pages of Goofish's public home feed (猜你喜欢, about 30 listing cards a page) - fresh listings across all categories, no input needed.",
            "default": 0
          },
          "monitorMode": {
            "title": "Only new since the last run",
            "type": "boolean",
            "description": "Remember what earlier runs delivered (in a named key-value store) and return only new listings, items, reviews and comments. Seller shops are read until a page holds nothing new, so a scheduled check of a shop is cheap.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Key-value store that holds what was delivered. Use one name per watch list.",
            "default": "goofish-monitor"
          },
          "resetMonitor": {
            "title": "Reset the monitor",
            "type": "boolean",
            "description": "Forget what earlier runs delivered (this run delivers everything again).",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. By default the run goes direct, then through one Apify datacenter and one residential exit only when Goofish refuses a route. Give your own proxy to use it instead."
          },
          "maxConcurrency": {
            "title": "Parallel item reads",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Items read at once. Default 4.",
            "default": 4
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}