{
  "openapi": "3.0.1",
  "info": {
    "title": "Coupang Scraper | Product Details, Prices and Options",
    "description": "Coupang scraper (쿠팡) for product details by link, product ID or keyword: price and discount, seller, every option with its own price, coupons, cashback, star breakdown, Rocket badges and delivery promise. 20 products in 13 seconds, 31 fields each. No account needed. Export to JSON, CSV or Excel.",
    "version": "1.0",
    "x-build-id": "bCErhcxLp2jPeSH3M"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~coupang-detail-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-coupang-detail-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/silentflow~coupang-detail-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-coupang-detail-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/silentflow~coupang-detail-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-coupang-detail-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": {
          "productUrls": {
            "title": "🔗 Product, search or category URLs",
            "type": "array",
            "description": "Coupang links or product IDs, one per line: product pages (<code>https://www.coupang.com/vp/products/8512549241</code>) or bare product IDs (<code>8512549241</code>), search result pages (<code>https://www.coupang.com/np/search?q=노트북</code>) and category pages (<code>https://www.coupang.com/np/categories/497135</code>). A search or category link keeps the sort and filters it carries. A product link with <code>vendorItemId</code> describes that exact option in the top-level price fields. Duplicates are removed.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "🔎 Search keywords",
            "type": "array",
            "description": "Words you would type in Coupang's search box, in Korean or English (e.g. <code>에어팟</code>, <code>샴푸</code>, <code>galaxy s25</code>). The first results page gives about 50 products; ask for more with Max products and the search goes on price range by price range, so one keyword can return several hundred products. Sponsored products are kept and flagged with <code>isAd</code>.",
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "🗂️ Category",
            "type": "string",
            "description": "Pick a Coupang category, or type any category ID: the number in a <code>coupang.com/np/categories/…</code> link (e.g. <code>497135</code> for laptops). With keywords, every keyword is searched inside this category. Without keywords, the category's own listing is read page by page, to its last page (517 different laptops in our test)."
          },
          "maxItems": {
            "title": "🔢 Max products",
            "minimum": 1,
            "type": "integer",
            "description": "The run stops after this many products (one row each), across links, keywords and the category. Linked products come first, then keyword and category results. With full product pages a run reads about one product per second; without them, hundreds of products take under a minute.",
            "default": 100
          },
          "includeDetails": {
            "title": "📋 Read each product's full page",
            "type": "boolean",
            "description": "On: every keyword and category result gets its full row, with seller, every option with its own price and stock, coupons, star breakdown and buyers' survey. Off: results come straight from Coupang's results pages, many times faster for large keyword or category runs: price and discount, cashback, rating and review count, Rocket, ad and overseas flags, delivery promise, shipping and image. Product links are always read in full.",
            "default": true
          },
          "sort": {
            "title": "↕️ Sort results by",
            "enum": [
              "scoreDesc",
              "salePriceAsc",
              "salePriceDesc",
              "saleCountDesc",
              "latestAsc"
            ],
            "type": "string",
            "description": "The order of Coupang's results page. <b>Best selling</b> and <b>Lowest price</b> surface different products than the default ranking for the same keyword or category.",
            "default": "scoreDesc"
          },
          "minPrice": {
            "title": "💰 Min price (won)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep results priced at or above this amount in Korean won (e.g. <code>10000</code>). Leave empty for no minimum."
          },
          "maxPrice": {
            "title": "💰 Max price (won)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep results priced at or below this amount in Korean won (e.g. <code>300000</code>). Leave empty for no maximum."
          },
          "minRating": {
            "title": "⭐ Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Keep results rated at least this many stars, from 1 to 5 (e.g. <code>4</code> or <code>4.5</code>). Products with no rating yet are left out. Leave empty to keep every rating."
          },
          "rocketOnly": {
            "title": "🚀 Rocket delivery only",
            "type": "boolean",
            "description": "Keep only results with Coupang's Rocket badge, sold by Coupang or by sellers shipping through Rocket (<code>isRocket</code> is true on every row).",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}