{
  "openapi": "3.0.1",
  "info": {
    "title": "Oregon Scraper | Contractor Licenses and Complaints",
    "description": "Oregon contractor license scraper for the CCB registry: phone, address, bond, insurance, workers' comp carrier, owners and officers, plus complaints, discipline and unpaid claims. Filter by county, trade, city, ZIP or license number. 50 contractors in 13 seconds, 35 fields each, fresh in 2026.",
    "version": "1.0",
    "x-build-id": "wzCVMNlv43CvfN54f"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~oregon-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-oregon-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~oregon-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-oregon-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~oregon-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-oregon-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": {
          "counties": {
            "title": "📍 Counties",
            "type": "array",
            "description": "Oregon counties to list, by the contractor's business address. Multnomah has about 5,100 active contractors, Washington 4,300, Lane 3,100, rural counties a few hundred. Leave empty to cover all of Oregon (about 45,800). Combine with license types and cities to narrow the list.",
            "items": {
              "type": "string",
              "enum": [
                "Baker",
                "Benton",
                "Clackamas",
                "Clatsop",
                "Columbia",
                "Coos",
                "Crook",
                "Curry",
                "Deschutes",
                "Douglas",
                "Gilliam",
                "Grant",
                "Harney",
                "Hood River",
                "Jackson",
                "Jefferson",
                "Josephine",
                "Klamath",
                "Lake",
                "Lane",
                "Lincoln",
                "Linn",
                "Malheur",
                "Marion",
                "Morrow",
                "Multnomah",
                "Polk",
                "Sherman",
                "Tillamook",
                "Umatilla",
                "Union",
                "Wallowa",
                "Wasco",
                "Washington",
                "Wheeler",
                "Yamhill",
                "Out of State"
              ],
              "enumTitles": [
                "Baker County",
                "Benton County",
                "Clackamas County",
                "Clatsop County",
                "Columbia County",
                "Coos County",
                "Crook County",
                "Curry County",
                "Deschutes County",
                "Douglas County",
                "Gilliam County",
                "Grant County",
                "Harney County",
                "Hood River County",
                "Jackson County",
                "Jefferson County",
                "Josephine County",
                "Klamath County",
                "Lake County",
                "Lane County",
                "Lincoln County",
                "Linn County",
                "Malheur County",
                "Marion County",
                "Morrow County",
                "Multnomah County",
                "Polk County",
                "Sherman County",
                "Tillamook County",
                "Umatilla County",
                "Union County",
                "Wallowa County",
                "Wasco County",
                "Washington County",
                "Wheeler County",
                "Yamhill County",
                "Out of state (contractors based outside Oregon)"
              ]
            }
          },
          "licenseTypes": {
            "title": "🛠️ License types",
            "type": "array",
            "description": "CCB license types (endorsements) to keep, any of them. <code>RGC</code> residential general contractors are the largest group (about 30,700), then residential specialty (<code>RSC</code>, roofers, painters, electricians' contracting arms) and commercial general contractors (<code>CGC2</code>). Leave empty for every type.",
            "items": {
              "type": "string",
              "enum": [
                "RGC",
                "RSC",
                "CGC2",
                "LBPR",
                "CSC2",
                "CGC1",
                "CSC1",
                "RLC",
                "OCHI",
                "OCLS",
                "RHISC",
                "RLSC",
                "RD",
                "CD",
                "CF",
                "RHSC",
                "RHEPSC",
                "RRC"
              ],
              "enumTitles": [
                "Residential General Contractor (RGC)",
                "Residential Specialty Contractor (RSC)",
                "Commercial General Contractor Level 2 (CGC2)",
                "Lead Based Paint Renovation Contractor (LBPR)",
                "Commercial Specialty Contractor Level 2 (CSC2)",
                "Commercial General Contractor Level 1 (CGC1)",
                "Commercial Specialty Contractor Level 1 (CSC1)",
                "Residential Limited Contractor (RLC)",
                "Oregon Certified Home Inspector (OCHI)",
                "Oregon Certified Locksmith (OCLS)",
                "Home Inspector Services Contractor (RHISC)",
                "Residential Locksmith Services Contractor (RLSC)",
                "Residential Developer (RD)",
                "Commercial Developer (CD)",
                "Construction Flagging Contractor (CF)",
                "Home Services Contractor (RHSC)",
                "Home Energy Performance Score Contractor (RHEPSC)",
                "Residential Restoration Contractor (RRC)"
              ]
            }
          },
          "searchTerms": {
            "title": "🔎 License numbers or names",
            "type": "array",
            "description": "Look up specific contractors across Oregon: a CCB license number (<code>234714</code>), a CCB license page link, or part of a business or owner name (<code>Brahms Construction</code>, <code>Smith Roofing</code>). Names match anywhere in the business name and in the Responsible Managing Individual's name. Counties and license types still apply: clear Counties to search the whole state.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max contractors",
            "minimum": 1,
            "type": "integer",
            "description": "How many contractors to return, newest licenses first. Each contractor is one row, whatever the number of license types it holds. In our tests, 200 contractors with their full record took 31 seconds.",
            "default": 100
          },
          "cities": {
            "title": "🏙️ Cities or ZIP codes",
            "type": "array",
            "description": "Cities (<code>Portland</code>, <code>Bend</code>) or 5-digit ZIP codes (<code>97220</code>) of the business address. Any of them matches.",
            "items": {
              "type": "string"
            }
          },
          "licensedSince": {
            "title": "🆕 First licensed on or after",
            "type": "string",
            "description": "Keep only contractors first licensed on or after this day: a date such as <code>2026-06-01</code>, or a span back from today such as <code>30 days</code> or <code>3 months</code>. Schedule it to get every new Oregon contractor each week."
          },
          "expiresAfter": {
            "title": "⏳ License expires on or after",
            "type": "string",
            "description": "Start of a renewal window: keep licenses expiring on or after this day (<code>2027-01-01</code>, or a span ahead of today such as <code>30 days</code>). The list is then sorted by expiry date, soonest first."
          },
          "expiresBefore": {
            "title": "⏳ License expires on or before",
            "type": "string",
            "description": "End of a renewal window: keep licenses expiring on or before this day (<code>2027-03-31</code>, or a span ahead of today such as <code>90 days</code>). Use it alone for every license due before that day."
          },
          "includeDetails": {
            "title": "📋 Complaint record, people and coverage",
            "type": "boolean",
            "description": "Add each contractor's CCB record: complaints, discipline and suspensions over the past 10 years, unpaid claims and penalties, entity type, owners, officers and members, assumed business names, workers' compensation carrier and policy, current bonds and insurance. Turn off for a faster list with the registry data only (license, contact, bond, insurance).",
            "default": true
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Show detailed logs.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}