BE-Lead-Hunter
Pricing
Pay per usage
Experimental business-contact research: supplied-page extraction, reviewed dataset reuse, gated website collection and evidence-only qualification. No new discovery Actor starts, mailbox verification, AI calls or outreach.
You can access the BE-Lead-Hunter programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "TaXKG9aj9xqNh43fC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wooden_turbojet~be-lead-hunter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wooden_turbojet-be-lead-hunter", "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/wooden_turbojet~be-lead-hunter/runs": { "post": { "operationId": "runs-sync-wooden_turbojet-be-lead-hunter", "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/wooden_turbojet~be-lead-hunter/run-sync": { "post": { "operationId": "run-sync-wooden_turbojet-be-lead-hunter", "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": { "runMode": { "title": "Run mode", "enum": [ "snapshots", "discovery_plan", "reuse_discovery", "crawl_simulation", "crawl_websites", "collect_discovery", "qualify_saved_collection", "save_reviews" ], "type": "string", "description": "Snapshot processing, offline plan/simulation, completed-run reuse, reviewed-source collection, pinned saved-evidence qualification or save-only review storage. No mode starts source Actors or sends email.", "default": "snapshots" }, "qualificationProfile": { "title": "Reviewed saved-collection qualification profile", "enum": [ "nashville-collection-v1" ], "type": "string", "description": "qualify_saved_collection only: pins the exact reviewed collection receipt and eight artifact checksums. No new source or website requests." }, "qualificationBundle": { "title": "Pinned saved collection evidence", "type": "object", "description": "qualify_saved_collection only: receipt and eight original UTF-8 artifact texts, prepared by the local input builder. Never include credentials. Exact pinned hashes and 250 KB total bound are enforced in code.", "default": {} }, "collectionProfile": { "title": "Reviewed website collection profile", "enum": [ "nashville-reviewed-agents-v1" ], "type": "string", "description": "collect_discovery only: selects the three manually reviewed named-agent identities and confirmed HTTPS starting sites. Other records remain deferred; this is not automatic agent qualification." }, "enableReviewPersistence": { "title": "Allow append-only review storage (also requires server authorization)", "type": "boolean", "description": "Explicitly opt into save_reviews mode. Trusted server authorization and deployment secrets are also required; disabled by default.", "default": false }, "reviewJob": { "title": "Review job — no credentials", "type": "object", "description": "save_reviews only: campaign, leads (1–10), sourceDigest, processorRevision, recordKind. Configure credentials only in trusted deployment secrets.", "default": {} }, "country": { "title": "Country", "type": "string", "description": "Target country for the supplied research records or discovery plan.", "default": "United States" }, "state": { "title": "Pilot state", "type": "string", "description": "The current pilot is Nashville, Tennessee. Historical Texas fixtures remain supported; supply the state explicitly.", "default": "Tennessee" }, "city": { "title": "Pilot city", "type": "string", "description": "The selected real-data pilot city is Nashville, Tennessee, not Texas.", "default": "Nashville" }, "category": { "title": "Business category", "type": "string", "description": "Business category used to filter supplied records and prepare discovery plans.", "default": "real estate" }, "marketScope": { "title": "Discovery scope", "enum": [ "city", "state_sample" ], "type": "string", "description": "Choose a specific city or an explicitly labeled state sample; this setting does not launch discovery.", "default": "city" }, "businessSegment": { "title": "Real estate segment", "enum": [ "", "brokerages", "property_managers", "individual_agents" ], "type": "string", "description": "The selected pilot targets individual agents. Search results still require review to distinguish agents from brokerages and teams.", "default": "individual_agents" }, "discoveryLimit": { "title": "Discovery sample limit", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum listings selected for the small discovery sample, up to ten.", "default": 10 }, "sourceRunId": { "title": "Completed Maps run ID (reuse mode only)", "type": "string", "description": "Existing completed Google Maps Actor run to inspect in reuse mode; this never starts a new source run." }, "sourceDatasetId": { "title": "Reviewed source dataset (limited-permission handoff)", "type": "string", "description": "reuse_discovery or collect_discovery: read the dataset for a reviewed source manifest and verify its content hash. Grants READ only. Run status is Console-attested, not re-read through the API. collect_discovery requires this field." }, "allowReadOnlyApify": { "title": "Allow read-only Apify API calls", "type": "boolean", "description": "Opt into reading an existing completed run with trusted SDK credentials; disabled by default.", "default": false }, "enableLiveRequests": { "title": "Allow website HTTP requests (also requires server authorization)", "type": "boolean", "description": "Opt into bounded website collection only when the server separately permits it; disabled by default.", "default": false }, "maxWebsites": { "title": "Maximum supplied websites to attempt", "minimum": 1, "maximum": 10, "type": "integer", "description": "Upper bound on supplied websites attempted during authorized website collection.", "default": 10 }, "maxHttpRequests": { "title": "HTTP attempt limit including robots and redirects", "minimum": 1, "maximum": 100, "type": "integer", "description": "Total HTTP attempt limit, including robots.txt checks and redirects.", "default": 40 }, "maxResponseBytes": { "title": "Maximum bytes per page response", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Maximum response-body bytes accepted for one page.", "default": 500000 }, "maxTotalResponseBytes": { "title": "Combined response-body byte limit", "minimum": 1, "maximum": 5000000, "type": "integer", "description": "Combined response-body byte budget across collected pages.", "default": 3000000 }, "minRequestIntervalSecs": { "title": "Minimum interval between requests to one origin", "minimum": 1, "maximum": 10, "type": "number", "description": "Minimum delay in seconds between requests to the same origin.", "default": 1 }, "maxCollectionElapsedSecs": { "title": "Elapsed check threshold (not a hard DNS/platform timeout)", "minimum": 1, "maximum": 180, "type": "number", "description": "Elapsed-time check threshold for collection, not a hard deadline for DNS or platform execution.", "default": 120 }, "simulationObservedAt": { "title": "Synthetic simulation timestamp", "type": "string", "description": "Explicit observation timestamp for fixture-only simulated responses." }, "httpFixtures": { "title": "Simulated HTTP responses only", "maxItems": 100, "type": "array", "description": "Fictional response fixtures for offline crawl simulation; not evidence of live HTTP collection.", "items": { "type": "object" }, "default": [] }, "dnsRecords": { "title": "Simulated DNS answers only", "type": "object", "description": "Fictional DNS answers for offline simulation; never trusted as live DNS evidence.", "default": {} }, "pilotBudgetUsd": { "title": "Pilot budget declaration (not a billing control)", "minimum": 0, "maximum": 5, "type": "number", "description": "Declared total pilot budget in USD, at most five dollars; this does not enforce Apify billing.", "default": 5 }, "pilotSpentUsd": { "title": "Declared pilot spend so far (not verified)", "minimum": 0, "type": "number", "description": "User-declared prior pilot costs in USD, not verified against provider billing.", "default": 0 }, "pendingCommitmentsUsd": { "title": "Declared pending run commitments", "minimum": 0, "type": "number", "description": "Declared outstanding pilot commitments in USD for budget planning.", "default": 0 }, "parentReserveUsd": { "title": "Estimated reserve for parent/platform costs", "minimum": 0, "type": "number", "description": "Estimated USD reserve for this Actor and platform costs, not a provider-enforced spending limit.", "default": 1 }, "discoveryBudgetUsd": { "title": "Proposed discovery allocation (not a billing cap)", "minimum": 0, "type": "number", "description": "Proposed USD allocation for a later approved discovery run; no discovery is launched by this field.", "default": 1 }, "maxLeads": { "title": "Maximum selected records", "minimum": 1, "maximum": 50, "type": "integer", "description": "Upper bound on selected business records processed into review output.", "default": 50 }, "maxPagesPerWebsite": { "title": "Maximum processed snapshots per business", "minimum": 1, "maximum": 4, "type": "integer", "description": "Maximum supplied HTML snapshots processed for one business.", "default": 4 }, "strictCityMatch": { "title": "Reject known addresses outside the selected city", "type": "boolean", "description": "Reject records with known addresses outside the explicitly selected city.", "default": true }, "requireWebsite": { "title": "Require a reported website", "type": "boolean", "description": "Exclude records without a reported website when enabled; disabled to retain no-website opportunities.", "default": false }, "discoveryItems": { "title": "Supplied discovery records", "maxItems": 500, "type": "array", "description": "Previously collected business records to normalize and review without starting discovery. The prefilled example is fictional, not a real lead.", "items": { "type": "object" }, "default": [] }, "websitePages": { "title": "Saved HTML snapshots", "maxItems": 200, "type": "array", "description": "Supplied saved HTML pages with source and observation metadata; these are not proof of a live scrape by this Actor.", "items": { "type": "object", "properties": { "url": { "title": "Snapshot URL", "description": "Original public page URL associated with the saved HTML snapshot.", "type": "string", "editor": "textfield", "maxLength": 2048 }, "html": { "title": "Saved HTML", "description": "Untrusted saved HTML content, processed as data and never executed.", "type": "string", "editor": "textarea", "maxLength": 500000 }, "statusCode": { "title": "HTTP status", "description": "Reported HTTP response status for the supplied snapshot.", "type": "integer", "editor": "number", "minimum": 100, "maximum": 599 }, "observedAt": { "title": "Observed at", "description": "Reported observation timestamp in ISO 8601 date-time format.", "type": "string", "editor": "textfield" }, "contentType": { "title": "Content type", "description": "Reported response content type for the saved page.", "type": "string", "editor": "textfield" }, "evidenceOrigin": { "title": "Evidence origin", "description": "Label distinguishing supplied, simulated, and HTTP-collected evidence; a label alone does not prove collection provenance.", "type": "string", "editor": "select", "enum": [ "SUPPLIED_SNAPSHOT", "SIMULATED_RESPONSE", "HTTP_FETCHED" ] }, "sourceWebsite": { "title": "Source website", "description": "Business website associated with this snapshot for conservative attribution.", "type": "string", "editor": "textfield" }, "leadKey": { "title": "Lead key", "description": "Optional supplied business identity used to attribute the snapshot to a review record.", "type": "string", "editor": "textfield" } }, "required": [ "url" ] }, "default": [] } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for BE-Lead-Hunter from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: