{
  "openapi": "3.0.1",
  "info": {
    "title": "KLEKT Sneaker & Apparel Resale Scraper",
    "description": "Scrape sneaker and streetwear listings from KLEKT (klekt.com). Browse the catalog with filters and extract product details, prices, and availability for resale market research and price monitoring.",
    "version": "0.1",
    "x-build-id": "PbcEMnPvchcJej1f1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~klekt-com-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-klekt-com-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/abotapi~klekt-com-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-klekt-com-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/abotapi~klekt-com-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-klekt-com-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Scrape mode",
            "enum": [
              "browse",
              "product-urls",
              "sitemap"
            ],
            "type": "string",
            "description": "Browse walks the KLEKT catalogue page by page using the strategy and filters below — this is the default and needs no other input. Product URLs scrapes the exact listing pages you paste. Full catalogue streams every product from the official sitemaps (about 15,000 products) and ignores the browse filters.",
            "default": "browse"
          },
          "productUrls": {
            "title": "Product URLs",
            "type": "array",
            "description": "KLEKT URLs to scrape (one per line), routed by shape: product pages https://klekt.com/product/new/<slug> (or /product/<slug>, with an optional /nl/ or /it/ prefix), pre-owned listings https://klekt.com/listing/<slug>-<id>, catalogue grids https://klekt.com/browse or /catalog (?page=N starts the walk at page N, ?brand=Nike, ?search=jordan and ?strategy=sale narrow server-side; /catalog/<brand>/<line> and the legacy /product/used/<id> also work; ?q and ?sort are not honoured by KLEKT's server and are reported in the run log) and the sitemap https://klekt.com/sitemap.xml. Left untouched, Product URLs mode scrapes one example of each shape, sharing Max items between them. Unsupported URLs are reported in the run log.",
            "default": [
              "https://klekt.com/product/new/yeezy-boost-350-v2-onyx",
              "https://klekt.com/listing/nike-air-max-1-black-cat-2025-us-8-brand-new-drfymgdk",
              "https://klekt.com/product/used/gytq6o25",
              "https://klekt.com/product/air-jordan-4-retro-black-cat-2025",
              "https://klekt.com/nl/product/new/yeezy-boost-350-v2-bone",
              "https://klekt.com/catalog",
              "https://klekt.com/catalog?page=2",
              "https://klekt.com/catalog?brand=Nike",
              "https://klekt.com/catalog?search=jordan",
              "https://klekt.com/catalog/hoka",
              "https://klekt.com/catalog/nike/air-jordan",
              "https://klekt.com/catalog?brand=Adidas&sort=price",
              "https://klekt.com/browse",
              "https://klekt.com/browse?page=2",
              "https://klekt.com/nl/catalog/adidas",
              "https://www.klekt.com/catalog/new-balance",
              "https://klekt.com/sitemap.xml"
            ],
            "items": {
              "type": "string"
            }
          },
          "strategy": {
            "title": "Catalogue section",
            "enum": [
              "trending",
              "used",
              "sale",
              "drops",
              "upcoming",
              "gift_cards"
            ],
            "type": "string",
            "description": "Which KLEKT catalogue section to walk. After KLEKT rebuilt its storefront (October 2026) only 'On sale' still narrows the catalogue as its own section; the other names are kept for saved tasks but walk the full catalogue (the run log says so when one is picked). 'Trending' (the default) walks the full catalogue.",
            "default": "trending"
          },
          "brand": {
            "title": "Brand",
            "type": "string",
            "description": "Filter to one brand, written the way KLEKT displays it (capitals and spaces, not a slug). Observed brands: Nike, Adidas, Air Jordan, New Balance, Yeezy, Asics, Nike SB, Crocs, On, Vans, Saucony, Supreme, Reebok, Converse, Puma, Travis Scott, Luxury, The North Face, Under Armour, Off White, Palace, Rick Owens, Stussy, Timberland, Mizuno, Karhu, Clarks, Fear Of God, Axel Arigato, Kaws, Ugg, Brooks, Brands Other. KLEKT's brand list differs per section, so this is free text; a brand that section does not carry simply returns no products.",
            "default": ""
          },
          "brandLine": {
            "title": "Brand line / model family",
            "type": "string",
            "description": "Optional narrower model family inside a brand. KLEKT's rebuilt catalogue no longer offers a server-side brand-line filter, so this is dropped with a note in the run log when set.",
            "default": ""
          },
          "productCategory": {
            "title": "Product category",
            "enum": [
              "",
              "Sneakers",
              "Streetwear",
              "Accessories"
            ],
            "type": "string",
            "description": "Limit to one KLEKT product category. These three are the complete set — their counts add up to the unfiltered total. Leave on Any for everything.",
            "default": ""
          },
          "sizeCategory": {
            "title": "Size category",
            "enum": [
              "",
              "Men",
              "Women",
              "Youth",
              "Default"
            ],
            "type": "string",
            "description": "Limit to one KLEKT size category. KLEKT's rebuilt catalogue no longer offers a server-side size-category filter, so this is dropped with a note in the run log when set.",
            "default": ""
          },
          "sizeMetric": {
            "title": "Size system (needed for Size)",
            "enum": [
              "",
              "US",
              "UK",
              "EU",
              "CM",
              "US-Men",
              "US-Women",
              "US-Kids",
              "Men-US",
              "WMNS_WOMEN_US",
              "FR",
              "IT",
              "DE",
              "Inch",
              "Length",
              "Presto",
              "model"
            ],
            "type": "string",
            "description": "The size system the Size field is written in. KLEKT's rebuilt catalogue no longer offers a server-side size filter, so this is dropped with a note in the run log when set.",
            "default": ""
          },
          "size": {
            "title": "Size (needs Size system)",
            "type": "string",
            "description": "One size, written the way KLEKT writes it (e.g. 10, 10.5, 44, M4/W6). KLEKT's rebuilt catalogue no longer offers a server-side size filter, so this is dropped with a note in the run log when set.",
            "default": ""
          },
          "boxCondition": {
            "title": "Box condition",
            "enum": [
              "",
              "good",
              "missing_lid",
              "damaged",
              "no_box",
              "replacement_box"
            ],
            "type": "string",
            "description": "Condition of the shoe box. KLEKT's rebuilt catalogue no longer offers a server-side box-condition filter, so this is dropped with a note in the run log when set. The listing cards still carry each listing's own box condition in the dataset output.",
            "default": ""
          },
          "listingType": {
            "title": "Listing type (Used section only)",
            "enum": [
              "",
              "used",
              "new_with_defect"
            ],
            "type": "string",
            "description": "Split into genuinely used pairs and new-with-defect pairs. KLEKT's rebuilt catalogue no longer offers a server-side listing-type filter, so this is dropped with a note in the run log when set.",
            "default": ""
          },
          "availability": {
            "title": "Availability",
            "enum": [
              "",
              "0",
              "1",
              "2"
            ],
            "type": "string",
            "description": "Limit to products KLEKT flags as available. KLEKT's rebuilt catalogue no longer offers a server-side availability filter, so this is dropped with a note in the run log when set.",
            "default": ""
          },
          "priceFrom": {
            "title": "Minimum price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return products priced at or above this many euros. Whole euros, not cents. Leave empty for no lower bound."
          },
          "priceTo": {
            "title": "Maximum price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return products priced at or below this many euros. Whole euros, not cents. Leave empty for no upper bound."
          },
          "fetchDetails": {
            "title": "Fetch product details",
            "type": "boolean",
            "description": "Fetch each product's own page for the full record (description, images, seller, last sold price, lowest listing price). Applies to Browse mode ONLY: switching it off there keeps the lighter catalogue row instead, with no per-product enrichment charge. Product URLs mode and Full catalogue mode have no catalogue row behind them — the product page is their only source of data — so detail fetching always runs in those two modes and the run log says so.",
            "default": true
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of products to scrape (up to 1,000,000). 0 = no cap (stop only at the end of the catalogue). Counts records actually returned, not pages read.",
            "default": 50
          },
          "maxPages": {
            "title": "Max catalogue pages (Browse mode)",
            "minimum": 0,
            "type": "integer",
            "description": "Safety bound on how many catalogue pages Browse mode walks (20 products per page). 0 (the default) means no input limit: the walk stops at the end of the section or at Max items, and code enforces a hard ceiling of 5000 pages.",
            "default": 0
          },
          "maxReviewsPerProduct": {
            "title": "Max reviews per product",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Community reviews to attach to each product row (reviewer, ratings, size, text, helpful votes), 20 per page. 0 = none. Capped at 1000 per product to bound run time. Applies wherever the product page is fetched.",
            "default": 20
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Whichever proxy groups you select here are the ones used — leave the groups empty to use your account's default pool. Turning Apify Proxy off connects directly, with no proxy traffic billed.",
            "default": {
              "useApifyProxy": true
            }
          },
          "resumeFromRunId": {
            "title": "Resume from a previous run (delta)",
            "type": "string",
            "description": "Optional. ID of a previous run of this Actor (or a dataset ID). Products already in that dataset are skipped, so this run returns only NEW products (a delta) and is not billed for the skipped ones. Combine both runs' datasets for the full set. Max items then counts only the new products. A resumed run never marks anything EXPIRED. For recurring monitoring of the same scope, use Incremental mode below instead.",
            "default": ""
          },
          "incrementalMode": {
            "title": "Incremental mode (recurring monitoring)",
            "type": "boolean",
            "description": "Turn this on for daily or recurring monitoring. The first run returns every product as NEW. Later runs compare each product against the last run and return only NEW, UPDATED and REAPPEARED products; an UPDATED row's changedFields names exactly what moved. Compared: asking price and currency, the market numbers (lowest listing, highest bid, last sold), availability, name, brand, size, box condition, seller, images and description. Never compared (they tick by themselves): postedAgo, likesCount and detailScraped, which are still returned on every row. Switch on Emit unchanged or Emit expired only if you also want those rows (and their billing). State is kept per scope (mode, section, brand, category, price range, product URLs, Fetch product details and the ignore settings); use State key to name or deliberately share a campaign.",
            "default": false
          },
          "stateKey": {
            "title": "State key (optional, incremental mode only)",
            "type": "string",
            "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to derive a key automatically from the scope; changing the ignore fields or change scope on an automatic key starts a fresh baseline (first run returns everything as NEW), so set a State key to keep one baseline across such changes.",
            "default": ""
          },
          "emitUnchanged": {
            "title": "Emit unchanged products (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return products that have not changed since the last run, marked UNCHANGED. This returns (and bills) rows you already have, so leave it off unless you want the full snapshot every run.",
            "default": false
          },
          "emitExpired": {
            "title": "Emit expired products (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return products that were tracked before but are no longer found, marked EXPIRED. Only produced after a COMPLETE scan: never when Max items or Max pages stopped the walk, when any request failed, or when Resume was used. EXPIRED means the product dropped out of this scope's listing, not that it is sold; read availability for stock. Returns (and bills) extra rows.",
            "default": false
          },
          "changeScope": {
            "title": "What counts as a change (incremental mode only)",
            "enum": [
              "all",
              "priceAndStock"
            ],
            "type": "string",
            "description": "All fields (default): any change to the product record, except the always-ignored postedAgo, likesCount and detailScraped, returns an UPDATED row. Price and availability only: only a change to the asking price, currency, lowest listing, highest bid, last sold price or availability returns an UPDATED row; name, images, description, seller and other details never do.",
            "default": "all"
          },
          "compactUpdates": {
            "title": "Compact update rows (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. When on, UPDATED and EXPIRED rows are short: id, url, name, current price and availability plus priceChanges (old and new value of each moved price field). NEW rows always carry the complete record. Compact rows carry no product-page data, so they do not trigger the detail-enrichment charge.",
            "default": false
          },
          "expireAfterMissedScans": {
            "title": "Expire after N missed full scans (incremental mode only)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Only used with Emit expired products. A product is marked EXPIRED only after it has been missing from this many complete scans in a row (default 1). Raise it (e.g. 3) so a listing that briefly drops out is not reported as gone. A product that comes back resets the count.",
            "default": 1
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Optional. Field names to exclude from UPDATED change detection, in addition to the built-in handling (postedAgo, likesCount and detailScraped never count). Use it when another field turns out to be noisy in your setup, e.g. imageUrl or images if the image host rotates. A dotted name such as images.url drops that key inside every element of a nested value. Ignored fields are still returned on every row.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send scraped KLEKT products into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify → Settings → API & Integrations, then select it here. Notion gets a rich page-per-product export; other connectors get a best-effort write/digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com).",
            "default": []
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which one page per product is created. Required to enable the Notion export; ignored by other connectors.",
            "default": ""
          },
          "maxNotifyListings": {
            "title": "Max products to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on products written to each connector per run. Does not affect the dataset.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}