{ "openapi": "3.0.1", "info": { "title": "Arizona ADRE Real Estate License Lookup Scraper", "description": "Search the Arizona Department of Real Estate public database for salesperson, broker, school and company licenses. Get license number, status, employing brokerage, designated broker, dates, employment history, complaints and business address. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "n4TeJUNaQshi9DaSU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~arizona-adre-realestate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-arizona-adre-realestate-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/scrapers_lat~arizona-adre-realestate-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-arizona-adre-realestate-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/scrapers_lat~arizona-adre-realestate-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-arizona-adre-realestate-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": { "searchType": { "title": "Search Type", "enum": [ "individual", "entity" ], "type": "string", "description": "Search individual licensees (salespersons/brokers) or licensed entities (companies/self-employed brokers).", "default": "individual" }, "cities": { "title": "Cities", "type": "array", "description": "One or more Arizona cities to search (one run covers all of them). Leave empty to search statewide with the other filters.", "items": { "type": "string" } }, "lastName": { "title": "Last Name (individuals)", "type": "string", "description": "Filter individual licensees by last name." }, "firstName": { "title": "First Name (individuals)", "type": "string", "description": "Filter individual licensees by first name." }, "legalName": { "title": "Legal Name (entities)", "type": "string", "description": "Filter entities by legal company name." }, "businessName": { "title": "Business / DBA Name (entities)", "type": "string", "description": "Filter entities by business (DBA) name." }, "licenseNo": { "title": "License Number", "type": "string", "description": "Look up an exact license number (e.g. SA584746000 or CO000004000)." }, "licenseType": { "title": "License Type", "type": "string", "description": "Individuals: All, Salesperson, Broker. Entities: All, Companies, Self Employed Brokers." }, "licenseStatus": { "title": "License Status", "enum": [ "All", "Currently Licensed", "Previously Licensed" ], "type": "string", "description": "All, Currently Licensed, or Previously Licensed.", "default": "Currently Licensed" }, "officeType": { "title": "Office Type (entities)", "enum": [ "All", "Main Offices", "Branch Offices" ], "type": "string", "description": "Entities only: All, Main Offices, or Branch Offices.", "default": "All" }, "county": { "title": "County", "type": "string", "description": "Filter by employer/business county." }, "zip": { "title": "ZIP Code", "type": "string", "description": "Filter by employer/business ZIP code." }, "withDetails": { "title": "Fetch full license details", "type": "boolean", "description": "Open each license's detail page for dates, employment history, designated broker, complaints, business address and more. Turn off for faster listing-only results.", "default": true }, "withLeadScore": { "title": "AI lead score (paid add-on)", "type": "boolean", "description": "Use AI to qualify each licensee as a B2B sales lead (score 0-100, tier, rationale). Billed per successfully scored record; paid Apify plans only.", "default": false }, "withProfileSummary": { "title": "AI profile summary (paid add-on)", "type": "boolean", "description": "Use AI to write a concise plain-English professional profile for each licensee. Billed per successfully summarized record; paid Apify plans only.", "default": false }, "maxLicensees": { "title": "Max Licensees To Scrape", "minimum": 1, "type": "integer", "description": "Maximum number of licensees to return in one run." } } }, "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 } } } } } } } } } }