{
  "openapi": "3.0.1",
  "info": {
    "title": "Whatnot Seller Scraper",
    "description": "Collect public Whatnot listings, live shows, seller profiles, and category insights by keyword, URL, seller username, or category. Get source fields such as prices, ratings, viewer counts, reviews, and source URLs in structured dataset rows.",
    "version": "0.0",
    "x-build-id": "KrBJlLw7ioMnss4gc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/maximedupre~whatnot/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-maximedupre-whatnot",
        "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/maximedupre~whatnot/runs": {
      "post": {
        "operationId": "runs-sync-maximedupre-whatnot",
        "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/maximedupre~whatnot/run-sync": {
      "post": {
        "operationId": "run-sync-maximedupre-whatnot",
        "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",
        "required": [
          "resultType",
          "findBy"
        ],
        "properties": {
          "resultType": {
            "title": "Result type",
            "enum": [
              "listings",
              "liveShows",
              "sellerProfiles",
              "categoryInsights",
              "mixedSearch"
            ],
            "type": "string",
            "description": "Choose the kind of public Whatnot records to return. Mixed search uses the product, live-show, and seller search surfaces."
          },
          "findBy": {
            "title": "Find Whatnot records by",
            "enum": [
              "keywords",
              "searchUrl",
              "directUrl",
              "sellerUsername",
              "category"
            ],
            "type": "string",
            "description": "Choose how to find the selected records. Use the method that matches the result type: keywords or a Search URL for search surfaces, Direct URL for a supported public page, Seller username for Seller profiles, or Category for category-based results."
          },
          "keywords": {
            "title": "Search keywords",
            "minItems": 1,
            "type": "array",
            "description": "Enter one or more keywords. They are used in one search with the selected result type and search surface.",
            "items": {
              "type": "string"
            }
          },
          "searchUrls": {
            "title": "Public search URLs",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more public Whatnot search URLs. Each URL is searched with the selected result type and search surface.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "A public Whatnot search URL.",
                  "pattern": "^https?://"
                }
              },
              "required": [
                "url"
              ]
            }
          },
          "directUrls": {
            "title": "Public Whatnot URLs",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more supported public Whatnot listing, seller, live-show, or category URLs.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "A supported public Whatnot page URL.",
                  "pattern": "^https?://"
                }
              },
              "required": [
                "url"
              ]
            }
          },
          "sellerUsernames": {
            "title": "Seller usernames",
            "minItems": 1,
            "type": "array",
            "description": "Enter one or more public Whatnot seller usernames for Seller profiles. A list uses one seller-focused search setup.",
            "items": {
              "type": "string"
            }
          },
          "includeReviews": {
            "title": "Include seller reviews",
            "type": "boolean",
            "description": "For Seller profiles, request public buyer reviews with ratings, text, dates, and reviewer identity. Source-provided seller review totals are included when available.",
            "default": false
          },
          "includeShowHistory": {
            "title": "Include seller show history",
            "type": "boolean",
            "description": "For Seller profiles, request public historical or scheduled shows for each seller when available.",
            "default": false
          },
          "category": {
            "title": "Category name or slug",
            "minLength": 1,
            "type": "string",
            "description": "Enter one public Whatnot category name or slug. Use this for Category insights or category-based listings, live shows, or seller results."
          },
          "categoryFilters": {
            "title": "Category filters",
            "minItems": 1,
            "type": "array",
            "description": "For Category insights, enter one or more filter values supported by the public Whatnot category page.",
            "items": {
              "type": "string"
            }
          },
          "categoryOrder": {
            "title": "Category order",
            "type": "string",
            "description": "For Category insights, choose a source-supported order for category results. You may enter another source value when needed."
          },
          "saleFormats": {
            "title": "Sale formats",
            "minItems": 1,
            "type": "array",
            "description": "For Listings and Mixed search, optionally keep only sale formats supported by Whatnot, such as auction or buy now.",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "For Listings and Mixed search, keep listings at or above this price."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "For Listings and Mixed search, keep listings at or below this price."
          },
          "liveOnly": {
            "title": "Live listings only",
            "type": "boolean",
            "description": "For Listings and Mixed search, keep only listings that are live now.",
            "default": false
          },
          "listingOrder": {
            "title": "Listing order",
            "type": "string",
            "description": "For Listings and Mixed search, choose a source-supported order for listing results. You may enter another source value when needed."
          },
          "maxItems": {
            "title": "Maximum items",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many records. Leave it empty to return all available results until the source is exhausted."
          },
          "monitorChanges": {
            "title": "Monitor new listings",
            "type": "boolean",
            "description": "For Listings and Mixed search, compare new public listing observations with prior observations for the same submitted target.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}