{
  "openapi": "3.0.1",
  "info": {
    "title": "Domeggook Scraper & API - Korean Wholesale, MOQ, Suppliers",
    "description": "Domeggook scraper and API for Korean wholesale products and suppliers (도매꾹) by keyword or URL. One result = one product: KRW price tiers, MOQ, stock, origin, shipping, dispatch time, supplier company, business number, address, phone, e-mail. No login. $1.50 per 1,000, product pages included.",
    "version": "1.0",
    "x-build-id": "ayGBXGbrd9LUYF2gX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rel8ble~domeggook-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rel8ble-domeggook-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/rel8ble~domeggook-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rel8ble-domeggook-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/rel8ble~domeggook-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rel8ble-domeggook-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": {
          "searchTerms": {
            "title": "Products (keywords or Domeggook URLs)",
            "type": "array",
            "description": "Provide at least one. Korean product keywords match best, e.g. \"양말\" (socks), \"텀블러\" (tumbler), \"핫팩\" (hand warmer); English words such as \"tumbler\" also work. Or domeggook.com URLs: a search or category list (https://www.domeggook.com/main/item/itemList.php?ca=01_15_00_00_00), a supplier catalog (itemList.php?sw=<sellerId>&sf=id) or one product (https://www.domeggook.com/44242921). Default [\"양말\"] (demo).",
            "default": [
              "양말"
            ],
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerSearch": {
            "title": "Max results per search",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Products saved per keyword / URL, integer >= 0. Default 20; 0 = everything (Domeggook shows up to 30,000 products per search, 100 per page). You pay per row.",
            "default": 20
          },
          "scrapeDetails": {
            "title": "Read product pages (price tiers, stock, supplier business card)",
            "type": "boolean",
            "description": "Default true. Reads each product page and adds every quantity price tier, stock, origin, shipping rule, dispatch time, category, ranking score, review count and the supplier business card (company name, business registration number, address, phone, e-mail, rating). Off = fastest card-only export (name, price, MOQ, shipping fee, supplier, grade, badges).",
            "default": true
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "ranking",
              "popular",
              "newest",
              "priceLow",
              "priceHigh",
              "moqLow",
              "moqHigh",
              "newSuppliers"
            ],
            "type": "string",
            "description": "Optional. Order of keyword results. Default \"ranking\" (Domeggook ranking). URLs keep their own sort.",
            "default": "ranking"
          },
          "uniqueSuppliers": {
            "title": "One row per supplier",
            "type": "boolean",
            "description": "Optional. true = keep only the first product of each supplier (a supplier lead list). Default false = one row per product.",
            "default": false
          },
          "minPrice": {
            "title": "Min unit price (KRW)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Skip products whose highest unit price is below this many won."
          },
          "maxPrice": {
            "title": "Max unit price (KRW)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Skip products whose lowest unit price is above this many won, e.g. 1000."
          },
          "maxMoq": {
            "title": "Max MOQ",
            "minimum": 1,
            "type": "integer",
            "description": "Optional. Skip products whose minimum order quantity is above this number, e.g. 10 for small-batch buying."
          },
          "onlyWithPrice": {
            "title": "Only products with a visible price",
            "type": "boolean",
            "description": "Optional. Skip products whose price is shown to logged-in business members only. Default false.",
            "default": false
          },
          "excludeSponsored": {
            "title": "Skip sponsored listings",
            "type": "boolean",
            "description": "Optional. Skip cards with a paid-placement icon. Default false.",
            "default": false
          },
          "fastDeliveryOnly": {
            "title": "Fast-delivery suppliers only",
            "type": "boolean",
            "description": "Optional. Keep only \"빠른배송\" (fast delivery) suppliers. Default false.",
            "default": false
          },
          "withEmailOnly": {
            "title": "Only suppliers with an e-mail",
            "type": "boolean",
            "description": "Optional. Keep only rows whose supplier card has an e-mail address (reads the product page). Default false.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Optional, advanced. Parallel requests, 1-20. Default 10.",
            "default": 10
          },
          "maxRequestRetries": {
            "title": "Max retries per request",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Optional, advanced. Retries per failed request (each on a new proxy session), 0-20. Default 8.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional, advanced. Default Apify Proxy (datacenter), which works for Domeggook. Switch to {\"useApifyProxy\": true, \"apifyProxyGroups\": [\"RESIDENTIAL\"]} only if the log shows repeated blocks.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}