{
  "openapi": "3.0.1",
  "info": {
    "title": "E-Commerce Price Tracker — Deal & Opportunity Intelligence",
    "description": "Track prices across Shopify and any e-commerce store and get a decision for every product: buy now, wait, or skip. Detects fake sales, scores deals and opportunities, flags price drops and restocks, and surfaces only what deserves attention, plus retailer, competitor and market intelligence.",
    "version": "2.1",
    "x-build-id": "klEwC4VXSS0NmMhWl"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ryanclinton~ecommerce-price-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ryanclinton-ecommerce-price-monitor",
        "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/ryanclinton~ecommerce-price-monitor/runs": {
      "post": {
        "operationId": "runs-sync-ryanclinton-ecommerce-price-monitor",
        "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/ryanclinton~ecommerce-price-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-ryanclinton-ecommerce-price-monitor",
        "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": [
          "productUrls"
        ],
        "properties": {
          "productUrls": {
            "title": "Product URLs",
            "maxItems": 1000,
            "type": "array",
            "description": "Product page URLs or Shopify store URLs to monitor. For Shopify stores, provide the store root URL (e.g. https://store.myshopify.com). For other sites, provide direct product page URLs.",
            "default": [
              "https://www.allbirds.com"
            ],
            "items": {
              "type": "string"
            }
          },
          "monitorMode": {
            "title": "Monitoring mode",
            "enum": [
              "general",
              "deal-hunting",
              "repricing",
              "stock-alert",
              "market-intelligence"
            ],
            "type": "string",
            "description": "What you're monitoring for. 'deal-hunting' (buyer watching for price drops + restocks), 'repricing' (seller watching competitor moves), 'stock-alert' (in/out of stock changes), 'market-intelligence' (prioritises unusual discounts, anomalies, near-lows and storewide sales over routine drops), or 'general' (balanced). Tunes which products land in the high-priority action queue.",
            "default": "general"
          },
          "watchlistName": {
            "title": "Watchlist name",
            "type": "string",
            "description": "Optional. Names an independent price-history watchlist so two schedules don't mix histories. Leave blank to use the default shared history. Price history persists across runs in a named store keyed by this name."
          },
          "priceDropAlertPct": {
            "title": "Price-drop alert threshold (%)",
            "minimum": 1,
            "maximum": 90,
            "type": "integer",
            "description": "A price move of at least this percentage vs the previous run flags a PRICE_DROP / PRICE_RISE change and raises the alert priority.",
            "default": 5
          },
          "outputProfile": {
            "title": "Output detail",
            "enum": [
              "minimal",
              "standard",
              "full"
            ],
            "type": "string",
            "description": "How much per-product detail to emit. 'minimal' = decision fields only (for Zapier/Make rules), 'standard' = decision layer + price (default), 'full' = everything including description, variants, and tags.",
            "default": "standard"
          },
          "productGroups": {
            "title": "Competitor groups",
            "type": "array",
            "description": "Optional. Group competing products/stores to get per-group market intelligence (market average price, best current deal, biggest recent drop, group leader). Each entry is { \"name\": \"Running Shoes\", \"urls\": [\"https://a.com/...\", \"https://b.com/...\"] }. Products in a group are also monitored individually."
          },
          "includePriceHistory": {
            "title": "Include price history",
            "type": "boolean",
            "description": "Attach each product's full tracked price-point history to its record. Off by default to keep records small.",
            "default": false
          },
          "checkShopifyApi": {
            "title": "Check Shopify API",
            "type": "boolean",
            "description": "Try the Shopify /products.json endpoint for Shopify stores. Disable if you only want generic scraping.",
            "default": true
          },
          "trackPriceHistory": {
            "title": "Track Price History",
            "type": "boolean",
            "description": "Store price history in Key-Value Store for change detection between runs.",
            "default": true
          },
          "notifyOnChange": {
            "title": "Notify on Price Change",
            "type": "boolean",
            "description": "Log price changes prominently when detected.",
            "default": false
          },
          "currency": {
            "title": "Expected Currency",
            "type": "string",
            "description": "Expected currency code for display purposes.",
            "default": "USD"
          },
          "maxProducts": {
            "title": "Max Products Per Store",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of products to track per store URL.",
            "default": 100
          },
          "notionConnector": {
            "title": "Notion connector (optional)",
            "type": "string",
            "description": "Archive each run's price alerts (drops, rises, restocks, and the action queue) to Notion. Create the connector once in Apify Console → Settings → MCP connectors, then select it here. The actor never sees your Notion token."
          },
          "notionDatabaseId": {
            "title": "Notion database ID",
            "type": "string",
            "description": "Target Notion data source to write into. Leave blank to create standalone pages."
          },
          "notionArchiveProfile": {
            "title": "Notion detail",
            "enum": [
              "summary",
              "per-product"
            ],
            "type": "string",
            "description": "summary = one page per run (counts + action queue). per-product = one page per action-queue product.",
            "default": "summary"
          },
          "slackConnector": {
            "title": "Slack connector (optional)",
            "type": "string",
            "description": "Post each run's price alerts (drops, rises, restocks, action queue) to your Slack. Create the connector in Apify Console → Settings → MCP connectors. The actor never sees your Slack token."
          },
          "slackChannel": {
            "title": "Slack channel",
            "type": "string",
            "description": "Channel to post to, e.g. #price-alerts. Leave blank for the connector's default channel."
          },
          "deliverTopN": {
            "title": "Products to include in delivery",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many action-queue products to include in the Slack/Notion delivery (1-50). The full set stays in the dataset.",
            "default": 10
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}