{ "openapi": "3.0.1", "info": { "title": "Agent to Brokerage Resolver", "description": "Look up any licensed real estate agent in 19 US states on official license registers: brokerage of record, its agent count and size band, and license status. Roster by firm or zip. No emails or phones. Each run sends its Apify run token to MMG's lookup service to verify the run, never stored.", "version": "0.1", "x-build-id": "thfnvimZPqebezxcy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~agent-brokerage-resolver/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-agent-brokerage-resolver", "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/mambalabs~agent-brokerage-resolver/runs": { "post": { "operationId": "runs-sync-mambalabs-agent-brokerage-resolver", "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/mambalabs~agent-brokerage-resolver/run-sync": { "post": { "operationId": "run-sync-mambalabs-agent-brokerage-resolver", "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": { "mode": { "title": "Mode", "enum": [ "lookup", "roster_firm", "roster_zip" ], "type": "string", "description": "lookup: find one agent or a list of agents. roster_firm: every active agent at one brokerage. roster_zip: brokerage offices in a zip code (NY, MO, OR, and VT), with their agents when asked.", "default": "lookup" }, "state": { "title": "State", "type": "string", "description": "Two letter licensing state, for example TX. Used with license_number, agent_name, or the brokerage fields." }, "license_number": { "title": "License number", "type": "string", "description": "Lookup mode. The agent's license number as the state register prints it. An exact match is the most reliable lookup." }, "agent_name": { "title": "Agent name", "type": "string", "description": "Lookup mode, when you have no license number. First and last name, for example Jane Doe. Add brokerage_name or city to narrow a common name." }, "brokerage_name": { "title": "Brokerage name", "type": "string", "description": "Lookup mode: narrows a name match. Firm roster mode: the brokerage to list, by its exact registered name." }, "city": { "title": "City or county", "type": "string", "description": "Lookup mode: narrows a name match by the brokerage office city or the license county." }, "licenses": { "title": "Licenses (batch)", "type": "string", "description": "Lookup mode, many at once. One per line (a JSON array also works): state, then license number, for example TX 0123456." }, "agents": { "title": "Agents by name (batch)", "type": "string", "description": "Lookup mode, many at once. One per line (a JSON array also works): state | name | brokerage (optional) | city (optional), for example TX | Jane Doe | Doe Realty | Austin." }, "brokerage_license_number": { "title": "Brokerage license number", "type": "string", "description": "Firm roster mode. The brokerage's license number, the most reliable way to name the firm." }, "zip": { "title": "Zip code", "type": "string", "description": "Zip roster mode. A five digit zip code. Zip roster covers NY, MO, OR, and VT, the states whose registers carry a business office zip." }, "zips": { "title": "Zip codes (batch)", "type": "string", "description": "Zip roster mode, many at once. One zip code per line. A JSON array also works." }, "include_agents": { "title": "Include agents in zip roster", "enum": [ "true", "false" ], "type": "string", "description": "Zip roster mode. Also list the active agents at each brokerage office. Each agent row is charged as a roster row.", "default": "false" }, "active_only": { "title": "Active licenses only", "enum": [ "true", "false" ], "type": "string", "description": "Roster modes. List only agents whose license is active.", "default": "true" }, "max_results": { "title": "Maximum roster rows per input", "type": "string", "description": "Roster modes. The most rows one brokerage or zip returns, 1 to 1000. Default 100." }, "max_charge_usd": { "title": "Maximum charge for this run (USD)", "type": "string", "description": "Optional. The run stops before the row that would take its charges over this amount. Leave empty to rely only on the maximum cost per run you set in Apify." }, "source_tag": { "title": "Source Tag", "type": "string", "description": "Internal attribution tag set by Mamba Labs on published task examples. Not required, and nothing depends on it. Leave it empty." } } }, "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 } } } } } } } } } }