{
  "openapi": "3.0.3",
  "info": {
    "title": "ECPRO 電商博士 API",
    "version": "1.0.0",
    "description": "台灣網站電商情報 API：開店平台、技術、廣告投放、流量估算、競品與名單。資料來源 ecpro.tw。",
    "contact": { "url": "https://ecpro.tw/api-docs" }
  },
  "servers": [{ "url": "https://ecpro.pages.dev/api/v1" }],
  "paths": {
    "/detect": {
      "get": {
        "summary": "即時偵測網站技術與廣告",
        "parameters": [{ "name": "url", "in": "query", "required": true, "schema": { "type": "string" }, "description": "網域，例如 pinkoi.com" }],
        "responses": { "200": { "description": "偵測結果（平台/技術/廣告像素/分析/ID）" } }
      }
    },
    "/site": {
      "get": {
        "summary": "資料庫網站檔案",
        "parameters": [{ "name": "domain", "in": "query", "required": true, "schema": { "type": "string" } }],
        "responses": { "200": { "description": "平台/產業/流量估算/分數/公司統編" } }
      }
    },
    "/competitors": {
      "get": {
        "summary": "同產業競品清單",
        "parameters": [
          { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" } },
          { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 12 } }
        ],
        "responses": { "200": { "description": "競品清單" } }
      }
    },
    "/prospect": {
      "get": {
        "summary": "依平台/產業撈電商名單",
        "parameters": [
          { "name": "platform", "in": "query", "schema": { "type": "string" } },
          { "name": "category", "in": "query", "schema": { "type": "string" } },
          { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100 } }
        ],
        "responses": { "200": { "description": "品牌名單" } }
      }
    },
    "/movers": {
      "get": {
        "summary": "平台搬家/廣告變動事件 feed",
        "parameters": [
          { "name": "type", "in": "query", "schema": { "type": "string", "enum": ["platform_changed", "ad_started", "ad_stopped"] } },
          { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50 } }
        ],
        "responses": { "200": { "description": "近期變動事件" } }
      }
    },
    "/stats": {
      "get": { "summary": "資料庫總覽統計", "responses": { "200": { "description": "收錄站數/電商數/公司數/平台分佈" } } }
    }
  }
}