{
  "openapi": "3.0.1",
  "info": {
    "title": "B2B Company Enrichment — Qualified Leads",
    "description": "Find qualified B2B leads and enrich known company domains with public business contacts, matching criteria and source evidence. Structured JSON for sales prospecting. $0.07/qualified lead; usage included.",
    "version": "0.2",
    "x-build-id": "l5iYqaIdthlLGhPTO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/impressionable_lupine~qualified-b2b-lead-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-impressionable_lupine-qualified-b2b-lead-finder",
        "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/impressionable_lupine~qualified-b2b-lead-finder/runs": {
      "post": {
        "operationId": "runs-sync-impressionable_lupine-qualified-b2b-lead-finder",
        "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/impressionable_lupine~qualified-b2b-lead-finder/run-sync": {
      "post": {
        "operationId": "run-sync-impressionable_lupine-qualified-b2b-lead-finder",
        "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": {
          "query": {
            "title": "Describe the businesses to find",
            "type": "string",
            "description": "Experimental provider-led discovery using documented filters only; source coverage and provider costs require validation. Prefer mode=enrich with supplied domains for the initial supported workflow. Unsupported criteria remain unknown."
          },
          "max_results": {
            "title": "Maximum qualified leads",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Target maximum. One run checks at most 120 candidates; larger requests return a partial report and require batching.",
            "default": 25
          },
          "companies": {
            "title": "Companies to enrich",
            "type": "array",
            "description": "Array of objects with website and/or name. This selects enrich mode by default. At most five companies may omit a website per run because each name requires a separate paid search-provider call; provide domains for larger batches.",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "title": "Company name",
                  "description": "Public business name when known.",
                  "type": "string",
                  "editor": "textfield"
                },
                "website": {
                  "title": "Company website",
                  "description": "Public company website URL or domain.",
                  "type": "string",
                  "editor": "textfield"
                }
              }
            }
          },
          "domains": {
            "title": "Website domains to enrich",
            "type": "array",
            "description": "Simple list of company domains or URLs. This also selects enrich mode.",
            "items": {
              "type": "string"
            }
          },
          "exclude_lead_ids": {
            "title": "Lead IDs already received",
            "type": "array",
            "description": "Optional lead_id values from previous runs. Matching leads are skipped and are never counted as billable results. Keep this list in your agent's own state for cross-run deduplication.",
            "items": {
              "type": "string",
              "pattern": "^[a-fA-F0-9]{64}$"
            }
          },
          "mode": {
            "title": "Workflow",
            "enum": [
              "discover",
              "enrich"
            ],
            "type": "string",
            "description": "enrich checks supplied companies/domains; discover searches supported providers. Providing companies or domains selects enrich by default."
          },
          "industry": {
            "title": "Industry or category",
            "type": "string",
            "description": "Requested business category. It must match observed category or labeled website evidence; unknown category cannot qualify a lead."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Requested city/region. Qualification needs sourced address fields; a domain extension is not location evidence. Broad continental regions remain unknown."
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Requested explicit country name or ISO country code. Checked against source-stated country/address evidence; never inferred from a domain suffix or phone prefix. Contradictions remain unknown."
          },
          "minimum_rating": {
            "title": "Minimum public rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Minimum source-provided rating from 0 to 5. Missing ratings remain unknown and cannot pass this criterion."
          },
          "minimum_review_count": {
            "title": "Minimum review count",
            "minimum": 0,
            "type": "number",
            "description": "Minimum source-provided review count. Missing counts remain unknown; website contact information does not establish reviews."
          },
          "website_required": {
            "title": "Require live website",
            "type": "boolean",
            "description": "Require a checked live public website. This verifies website availability, not current business operation.",
            "default": false
          },
          "email_required": {
            "title": "Require public business email",
            "type": "boolean",
            "description": "Require an observed public business email. Publication is checked; mailbox ownership and deliverability are not tested.",
            "default": false
          },
          "contact_required": {
            "title": "Require public business contact",
            "type": "boolean",
            "description": "Require at least one verified public business email or phone number. Use email_required and phone_required together only when both are needed.",
            "default": false
          },
          "phone_required": {
            "title": "Require public phone",
            "type": "boolean",
            "description": "Require an observed public business phone number. Publication is checked; the number is not called.",
            "default": false
          },
          "social_profile_required": {
            "title": "Require public social profile",
            "type": "boolean",
            "description": "Require at least one observed linked public social profile. Profile ownership and activity are not independently verified.",
            "default": false
          },
          "exclude_chains": {
            "title": "Prefer likely independent businesses",
            "type": "boolean",
            "description": "An inference from public signals; not proof of ownership.",
            "default": false
          },
          "exclude_booking": {
            "title": "Exclude obvious online booking",
            "type": "boolean",
            "description": "No observed booking link is not proof no booking exists.",
            "default": false
          },
          "keywords": {
            "title": "Required keywords",
            "type": "array",
            "description": "Phrases required in the sourced company name, description or category. Phrase matching is explicit; no latent purchase intent is inferred.",
            "items": {
              "type": "string"
            }
          },
          "exclude_keywords": {
            "title": "Excluded keywords",
            "type": "array",
            "description": "Phrases that disqualify a company when present in its sourced name, description or category. Missing descriptive content remains unknown.",
            "items": {
              "type": "string"
            }
          },
          "discovery_source": {
            "title": "Discovery source",
            "enum": [
              "auto",
              "maps",
              "search",
              "osm"
            ],
            "type": "string",
            "description": "auto uses bounded Maps and Search discovery. A specific maps, search, or osm value uses only that source family; osm does not silently launch paid Maps or Search providers. OSM is explicit-only while public Overpass availability is unreliable.",
            "default": "auto"
          },
          "include_unqualified": {
            "title": "Include rejected or unknown candidates",
            "type": "boolean",
            "description": "Return additional audit rows when true. Only qualification.qualified=true rows count as paid qualified-lead events.",
            "default": false
          },
          "include_hiring_signal": {
            "title": "Hiring signal (experimental)",
            "type": "boolean",
            "description": "Reserved; currently reported as unsupported and never inferred.",
            "default": false
          },
          "enrichment_options": {
            "title": "Enrichment options",
            "type": "object",
            "description": "Optional public website checks.",
            "properties": {
              "contacts": {
                "title": "Contacts",
                "description": "Read public business contact information.",
                "type": "boolean"
              },
              "socials": {
                "title": "Socials",
                "description": "Read public company social links.",
                "type": "boolean"
              },
              "booking": {
                "title": "Booking",
                "description": "Look for obvious booking links.",
                "type": "boolean"
              },
              "technology": {
                "title": "Technology",
                "description": "Look for explicit website technology signals.",
                "type": "boolean"
              }
            }
          },
          "active_required": {
            "title": "Require evidence of current activity",
            "type": "boolean",
            "description": "Require verified current operation. A live website alone is only a low-confidence inference, so this criterion remains unknown and the lead is not qualified without stronger evidence.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}