{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Company URL - Mass Profile Finder & Employee List",
    "description": "Find LinkedIn company profiles in bulk from company names, websites, or domains. Extract LinkedIn company URLs, profile details, industry data, follower counts, and business information to streamline lead generation, sales prospecting, recruitment, and market research.",
    "version": "0.1",
    "x-build-id": "ARH6laqrhLC8eU74D"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapier~linkedin-company-url-mass-profile-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapier-linkedin-company-url-mass-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-company-url-mass-profile-finder/runs": {
      "post": {
        "operationId": "runs-sync-scrapier-linkedin-company-url-mass-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-company-url-mass-profile-finder/run-sync": {
      "post": {
        "operationId": "run-sync-scrapier-linkedin-company-url-mass-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",
        "properties": {
          "companyNames": {
            "title": "🏢 Company Names (bulk input)",
            "type": "array",
            "description": "One company name per line — e.g. <code>Stripe</code>, <code>OpenAI</code>, <code>Notion Labs</code>. Each name resolves to its LinkedIn company page, and (if enabled below) to a list of its public employees. ✨",
            "items": {
              "type": "string"
            }
          },
          "fetchEmployees": {
            "title": "👥 Find employees for each company",
            "type": "boolean",
            "description": "When ON, the Actor discovers public LinkedIn profiles of people who work at each resolved company and emits them as child rows (type=<code>employee</code>). Coverage is PARTIAL and logged-out — LinkedIn blocks many guest profile views (HTTP 999), so expect a handful per company, never a full roster. Default is ON.",
            "default": true
          },
          "maxEmployeesPerCompany": {
            "title": "🔢 Max employees per company",
            "minimum": 0,
            "maximum": 40,
            "type": "integer",
            "description": "Upper bound on employee rows kept per company. Example: <code>6</code> keeps up to 6 employees for each company. Use <code>0</code> for unlimited (capped internally at 40). Default is 6.",
            "default": 6
          },
          "titleFilter": {
            "title": "🎯 Job-title filter (keep only matching roles)",
            "type": "array",
            "description": "Keep only employees whose headline / job title contains one of these keywords (case-insensitive). Example: <code>[\"Founder\", \"CEO\", \"Head of Sales\", \"Recruiter\"]</code>. Leave EMPTY to keep every employee found. ✂️",
            "items": {
              "type": "string"
            }
          },
          "region": {
            "title": "🌍 Search Region",
            "enum": [
              "us-en",
              "uk-en",
              "ca-en",
              "au-en",
              "in-en",
              "wt-wt"
            ],
            "type": "string",
            "description": "Region/language used for the company + employee lookup. <code>us-en</code> returns English titles like <i>“Stripe - LinkedIn”</i>.",
            "default": "us-en"
          },
          "maxConcurrency": {
            "title": "⚡ Speed (companies in parallel)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many companies are processed in parallel. Higher = faster, but uses your proxy pool quicker. Employees within a company are fetched sequentially to stay gentle on LinkedIn. 🏎️",
            "default": 10
          },
          "sessionCookie": {
            "title": "🔑 LinkedIn li_at cookie (optional — lifts employee coverage)",
            "type": "string",
            "description": "OPTIONAL. Paste your LinkedIn <code>li_at</code> session cookie value to reduce HTTP 999 guest blocks and recover more employee profiles. Leave EMPTY to run fully logged-out (default). Use at your own risk per LinkedIn's Terms."
          },
          "companySearchSuffix": {
            "title": "🧲 Company Search Suffix",
            "type": "string",
            "description": "Phrase appended to each company name to surface its LinkedIn page. Leave the default unless you know what you're doing. 🛠️",
            "default": "linkedin company"
          },
          "includeNotFound": {
            "title": "📭 Include “not found” company rows",
            "type": "boolean",
            "description": "When ON, companies with no LinkedIn page still get a row (with empty URL) so your company output lines up 1-to-1 with your input.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy Configuration",
            "type": "object",
            "description": "By default the Actor runs with NO proxy. If a request is blocked, it automatically falls back to a Datacenter proxy, then a Residential proxy — and sticks with Residential for the rest of the run. 🔄",
            "default": {
              "useApifyProxy": 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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}