{
  "openapi": "3.0.1",
  "info": {
    "title": "Target Scraper - Product Prices, Stock and Reviews",
    "description": "Extract Target.com US products, prices, ratings, reviews, store locations and category data. Search by keyword, brand or TCIN and pay per delivered row plus a start fee.",
    "version": "0.1",
    "x-build-id": "Sdje1ZDhlrDQrhFDN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lentic_clockss~target-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lentic_clockss-target-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/lentic_clockss~target-scraper/runs": {
      "post": {
        "operationId": "runs-sync-lentic_clockss-target-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/lentic_clockss~target-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-lentic_clockss-target-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": {
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Search keyword, e.g. paper towels. Used by Keyword search, Aisles search and Autocomplete."
          },
          "productUrl": {
            "title": "Product URL",
            "pattern": "^$|^\\s*(https?://)?([A-Za-z0-9-]+\\.)*target\\.com(/.*)?\\s*$",
            "type": "string",
            "description": "A target.com product page link, e.g. https://www.target.com/p/-/A-12345678."
          },
          "categoryUrl": {
            "title": "Category/Brand URL",
            "pattern": "^$|^\\s*(https?://)?([A-Za-z0-9-]+\\.)*target\\.com(/.*)?\\s*$",
            "type": "string",
            "description": "A target.com category or brand page link. For a brand page, explicitly choose Brand browse."
          },
          "tcin": {
            "title": "TCIN",
            "type": "string",
            "description": "One Target item number, such as 89110863. With automatic mode, this selects product detail."
          },
          "tcins": {
            "title": "TCINs",
            "type": "array",
            "description": "Several TCINs (Target item numbers). Used by Product summaries and Circle membership; each TCIN is one input.",
            "items": {
              "type": "string"
            }
          },
          "categoryId": {
            "title": "Category ID",
            "type": "string",
            "description": "Target category identifier, such as 5xtg6. You may omit the N- prefix."
          },
          "brandId": {
            "title": "Brand ID",
            "type": "string",
            "description": "Target brand identifier for brand browse. Use the identifier from the brand page."
          },
          "categorySlug": {
            "title": "Category slug",
            "type": "string",
            "description": "Category path text, such as electronics. A category ID or URL is usually more precise."
          },
          "brandSlug": {
            "title": "Brand slug",
            "type": "string",
            "description": "Brand path slug (e.g. apple)."
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "auto",
              "keywordSearch",
              "categoryBrowse",
              "brandBrowse",
              "productDetail",
              "storeLocations",
              "taxonomyBrowse",
              "categoryTree",
              "aislesSearch",
              "productReviews",
              "productSummaries",
              "autocomplete",
              "findsPosts",
              "circleMembership",
              "itemDetail",
              "threeDimensional"
            ],
            "type": "string",
            "description": "Choose what to collect, or use Auto to select a mode from the target you fill. Product URLs and TCINs select details, TCIN lists select summaries, and category, brand or keyword fields select their matching listings.",
            "default": "auto"
          },
          "maxResults": {
            "title": "Max results per input",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum rows for each user input (for example, each TCIN in tcins; scalar modes have one input). The default is 70. Larger values are collected in parts of 70. All row types share each input's allowance, and the run stops at your maximum total charge. Free Apify plan: 200 rows per run and 10 runs.",
            "default": 70
          },
          "zip": {
            "title": "ZIP",
            "type": "string",
            "description": "US ZIP for location-sensitive price and stock, defaulting to 52404. In priced product modes, a changed ZIP with the default store attempts a nearby-store lookup; if it fails, the default store can remain."
          },
          "storeId": {
            "title": "Store ID",
            "type": "string",
            "description": "Target store identifier for price and stock, defaulting to 1771. If you change ZIP while retaining this default, priced product modes attempt to select a nearby store."
          },
          "storeIds": {
            "title": "Store IDs",
            "type": "array",
            "description": "Additional Target store identifiers for availability context. Enter identifiers as strings.",
            "items": {
              "type": "string"
            }
          },
          "fulfillmentType": {
            "title": "Fulfillment filter",
            "enum": [
              "any",
              "pickup",
              "same_day",
              "shipping",
              "shop_in_store"
            ],
            "type": "string",
            "description": "Filter eligible listings by pickup, same-day delivery, shipping or in-store shopping. Any leaves this filter unset.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort",
            "enum": [
              "relevance",
              "Featured",
              "PriceLow",
              "PriceHigh",
              "RatingHigh",
              "bestselling",
              "newest"
            ],
            "type": "string",
            "description": "Choose relevance, featured products, price, rating, best sellers or newest products for listing modes.",
            "default": "relevance"
          },
          "facets": {
            "title": "Facets",
            "type": "array",
            "description": "Additional Target filter values, such as d_deals:sale. Leave empty when no extra filter is needed.",
            "items": {
              "type": "string"
            }
          },
          "preselectTcin": {
            "title": "Preselect child TCIN",
            "type": "string",
            "description": "Child variant item number to select when reading product details."
          },
          "expandFacets": {
            "title": "Expand facets",
            "type": "boolean",
            "description": "Also search available delivery-channel and deal filters. All delivered rows share the same per-input allowance.",
            "default": false
          },
          "expandVariants": {
            "title": "Expand variants",
            "type": "boolean",
            "description": "Include available child variant details and prices. Use Emit variants as rows to request separately billed variant rows.",
            "default": true
          },
          "includeVariantRows": {
            "title": "Emit variants as rows",
            "type": "boolean",
            "description": "Opt in to one separately billed row per child variant. Variant rows share the same ZIP and resolved pricing-store context as their parent.",
            "default": false
          },
          "maxPages": {
            "title": "Max pages",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "Legacy page setting retained for compatibility. Collection may continue beyond this value to fill the per-input row allowance; use Max results per input to limit delivery.",
            "default": 3
          },
          "taxonomyDepth": {
            "title": "Taxonomy depth",
            "minimum": 1,
            "maximum": 4,
            "type": "integer",
            "description": "How many category levels to explore in Category tree mode, from 1 to 4.",
            "default": 2
          },
          "enrichDetails": {
            "title": "Add product details",
            "type": "boolean",
            "description": "Add available product-page fields to listing rows, up to Enrich limit. Enabled by default.",
            "default": true
          },
          "enrichLimit": {
            "title": "Enrich limit",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum listing rows to enrich with product-page details, from 0 to 20. Zero disables this enrichment.",
            "default": 1
          },
          "includeFulfillment": {
            "title": "Include fulfillment",
            "type": "boolean",
            "description": "Include available pickup, delivery and shipping details on supported product rows. Enabled by default.",
            "default": true
          },
          "maxReviews": {
            "title": "Max reviews",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum available review rows requested in Product reviews mode, also limited by Max results per input. Zero uses the default of 20; complete review history is not guaranteed.",
            "default": 20
          },
          "workerBaseUrl": {
            "title": "Developer testing override",
            "type": "string",
            "description": "Leave empty. Used only by the developer for testing."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}