{ "openapi": "3.0.1", "info": { "title": "CA DRE Real Estate License Lookup Scraper", "description": "Look up California real estate salesperson, broker, and corporation licenses from the CA Department of Real Estate. Search by name or license number, filter by type and status, get expiration dates, disciplinary history, and brokerage affiliations.", "version": "1.0", "x-build-id": "vNCmWWy2TmN0GetfF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ca-dre-real-estate-license-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ca-dre-real-estate-license-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/crawlerbros~ca-dre-real-estate-license-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ca-dre-real-estate-license-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/crawlerbros~ca-dre-real-estate-license-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ca-dre-real-estate-license-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "byName", "byLicenseNumber", "byOfficeAddress" ], "type": "string", "description": "How to look up licenses.", "default": "byName" }, "licenseeName": { "title": "Licensee / company name (mode=byName)", "type": "string", "description": "Last name, First name (e.g. `Smith, John`) or a company/brokerage name (e.g. `Keller Williams`). Matches DRE's own name search.", "default": "Smith, John" }, "cityFilter": { "title": "Mailing address city (mode=byName, optional)", "type": "string", "description": "Narrow a name search to licensees whose DRE mailing address city matches (e.g. `Sacramento`). May differ from the licensee's main/branch office city." }, "licenseNumber": { "title": "License number (mode=byLicenseNumber)", "type": "string", "description": "The DRE license ID, e.g. `01310197`. Leading zeros are optional." }, "officeStreetAddress": { "title": "Office street name (mode=byOfficeAddress)", "type": "string", "description": "Street name of a broker/corporation's main or branch office (e.g. `Canon Dr`). DRE's own office-address search — returns brokers and corporations only, not individual salespersons." }, "officeStreetNumber": { "title": "Office street number (mode=byOfficeAddress, optional)", "type": "string", "description": "Street number to narrow the office-address search (e.g. `145`). If no match is found with a street number, try leaving it blank." }, "officeCity": { "title": "Office city (mode=byOfficeAddress, optional)", "type": "string", "description": "City to narrow the office-address search (e.g. `Beverly Hills`)." }, "licenseType": { "title": "Filter by license type", "enum": [ "", "salesperson", "broker", "corporation" ], "type": "string", "description": "Only emit licenses of this type. Leave unset for all types.", "default": "" }, "licenseStatus": { "title": "Filter by license status", "enum": [ "", "licensed", "licensed nba", "expired", "revoked", "restricted", "surrendered", "voided", "deceased", "canceled officer", "conditional suspension", "flag suspended", "government service", "military service", "withheld denied", "17520 fc suspended", "11350.6 w&i suspended", "withheld per b&p 494.5", "494.5 b&p suspended" ], "type": "string", "description": "Only emit licenses currently in this DRE status. Leave unset for all statuses. Applying this can slow down broad name searches because DRE only exposes status on the per-license detail page.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted license records.", "default": 20 } } }, "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 } } } } } } } } } }