{
  "openapi": "3.0.1",
  "info": {
    "title": "CalRecycle SWIS Waste & Recycling Facility Permits Scraper",
    "description": "Extract California solid waste, recycling, organics composting, transfer station, and landfill permits, proposed projects, operator HQ contacts, inspections, and enforcement actions from CalRecycle SWIS. Built for daily scheduled delta alerts, Clay/CRM enrichment, and MCP agents.",
    "version": "1.0",
    "x-build-id": "Npf8vFc8a7b2xkXI0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zinky_atelier~calrecycle-swis-waste-facility-permits/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zinky_atelier-calrecycle-swis-waste-facility-permits",
        "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/zinky_atelier~calrecycle-swis-waste-facility-permits/runs": {
      "post": {
        "operationId": "runs-sync-zinky_atelier-calrecycle-swis-waste-facility-permits",
        "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/zinky_atelier~calrecycle-swis-waste-facility-permits/run-sync": {
      "post": {
        "operationId": "run-sync-zinky_atelier-calrecycle-swis-waste-facility-permits",
        "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": {
          "county": {
            "title": "California County (Optional)",
            "type": "string",
            "description": "Filter by one or more California county names (comma-separated, e.g. 'Los Angeles' or 'Alameda, Contra Costa, Orange'). Leave blank to query all 58 California counties.",
            "default": ""
          },
          "regulatoryStatus": {
            "title": "Regulatory Status",
            "enum": [
              "",
              "Proposed",
              "Permitted",
              "Notification",
              "Exempt",
              "Excluded",
              "Unpermitted",
              "Suspended",
              "Revoked",
              "Surrendered",
              "Pre-regulation",
              "Not Currently Regulated",
              "TBD (Pending Investigation)"
            ],
            "type": "string",
            "description": "Filter by CalRecycle SWIS Regulatory Status. Select 'Proposed' for pre-permit new facility leads or 'Permitted' for licensed operating facilities. Leave blank for all statuses.",
            "default": ""
          },
          "operationalStatus": {
            "title": "Operational Status",
            "enum": [
              "",
              "Planned",
              "Active",
              "Inactive",
              "Closing",
              "Closed",
              "Clean Closed",
              "Absorbed",
              "Abandoned",
              "To be Determined"
            ],
            "type": "string",
            "description": "Filter by Site Operational Status ('Planned', 'Active', 'Inactive', 'Closing', 'Closed', 'Clean Closed', 'Absorbed', 'Abandoned', 'To be Determined'). Leave blank for all operational statuses.",
            "default": ""
          },
          "searchQuery": {
            "title": "Keyword / Facility Name / SWIS Number (Optional)",
            "type": "string",
            "description": "Optional text search matching Site Name, SWIS Number (e.g. '01-AA-0003'), or facility alias/AKA (e.g. 'Transfer', 'Compost', 'Organics', 'Landfill').",
            "default": ""
          },
          "enrichFacilityDetails": {
            "title": "Enrich Facility Details (Address, Operator HQ, LEA, Activities, Inspections & Enforcement)",
            "type": "boolean",
            "description": "Fetches each facility's SWIS Summary & Detail profile to extract physical site address, lat/long coordinates, operator name & HQ address/phone, landowners, Local Enforcement Agency (LEA), permitted activities, recent inspections/violations, and enforcement actions.",
            "default": true
          },
          "onlyNew": {
            "title": "Only New or Status-Changed Facilities (Stateful SEEN_FACILITIES Delta Mode)",
            "type": "boolean",
            "description": "Tracks seen SWIS numbers and their Regulatory/Operational status in Key-Value Store ('SEEN_FACILITIES'). When enabled on scheduled runs, skips unchanged facilities and emits only brand-new sites ('NEW_FACILITY') or status transitions ('STATUS_CHANGED', e.g. Proposed -> Permitted).",
            "default": false
          },
          "maxItems": {
            "title": "Max Facilities to Emit",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum number of facility records to emit in this run.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}