{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Mass Company Profile Finder : Business Email & Website",
    "description": "LinkedIn Mass Company Profile Finder — Find company profiles in bulk and extract business emails, websites, company names, industries, locations, employee counts, and LinkedIn URLs. Build targeted B2B lead lists for sales, prospecting, and market research.",
    "version": "0.1",
    "x-build-id": "O43lzW1Eiie3qJgDH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapier~linkedin-mass-company-profile-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapier-linkedin-mass-company-profile-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/scrapier~linkedin-mass-company-profile-finder/runs": {
      "post": {
        "operationId": "runs-sync-scrapier-linkedin-mass-company-profile-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/scrapier~linkedin-mass-company-profile-finder/run-sync": {
      "post": {
        "operationId": "run-sync-scrapier-linkedin-mass-company-profile-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",
        "required": [
          "urls"
        ],
        "properties": {
          "urls": {
            "title": "🔍 Keywords / Company Names / Domains (required)",
            "type": "array",
            "description": "Any list of search keywords — domains (`alma.fr`), exact company names (`\"Acme Corp\"`), brand + qualifier (`\"Stripe\" payments`), or plain text. Each line is searched independently. One keyword per line; quotes force an exact-match phrase.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerKeyword": {
            "title": "📊 Max Results Per Keyword",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Upper bound on how many search results are inspected per keyword per engine. Example: maxResultsPerKeyword=30 (default) checks up to 30 results per engine per keyword. Higher values find more companies for broad keywords but take longer.",
            "default": 30
          },
          "workers": {
            "title": "🧵 Concurrent Workers",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many keywords are processed in parallel. Example: workers=3 (default) searches 3 keywords at once. Raise it to speed up large keyword lists; lower it if you see more blocks/retries.",
            "default": 3
          },
          "maxRetries": {
            "title": "🔁 Max Retries Per Engine",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "How many times a single engine is retried (with backoff) before the run escalates to the next proxy tier. Example: maxRetries=2 (default) tries a blocked/failed request up to 2 extra times before escalating.",
            "default": 2
          },
          "includeEmailDiscovery": {
            "title": "📧 Discover Business Email Per Company",
            "type": "boolean",
            "description": "When enabled, for each LinkedIn company found the actor runs a capped set of business-email search patterns (e.g. \"contact@\", \"email us at\", \"careers\"+\"@\") and returns the first non-personal (non-Gmail/Yahoo/Outlook) email it finds as `businessEmail`. Coverage varies by company — many companies will return `null` when no public business email is indexed. Off by default.",
            "default": false
          },
          "maxEmailQueriesPerCompany": {
            "title": "🔢 Max Email Queries Per Company",
            "minimum": 1,
            "maximum": 29,
            "type": "integer",
            "description": "Caps how many email-search patterns are tried per company before giving up (only used when 'Discover Business Email Per Company' is on). Example: maxEmailQueriesPerCompany=5 (default) tries the 5 highest-yield patterns, stopping early the moment an email is found. Raise for higher coverage at the cost of more requests per company.",
            "default": 5
          },
          "includeWebsiteDiscovery": {
            "title": "🌐 Resolve Company Website",
            "type": "boolean",
            "description": "When enabled, runs one follow-up search per found company to resolve its official website/domain (excluding LinkedIn and other social/directory sites), returned as `companyWebsite`. Off by default. When both this and email discovery are on, the resolved website's domain is used to sharpen the email search.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy Configuration",
            "type": "object",
            "description": "Default: no proxy (saves cost). If search engines block the request, the actor automatically escalates: no-proxy → Datacenter → Residential (3 retries). After a successful fallback, the chosen proxy is reused for all remaining keywords. You can also pre-configure Apify proxy here if you want to start with one."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}