{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Mass Company Profile Finder With Multi-Engine Search",
    "description": "LinkedIn Mass Company Profile Finder discovers public company profiles in bulk using multiple search engines. Extract company names, industries, locations, employee counts, websites, descriptions, and profile URLs for B2B prospecting, lead generation, and market research.",
    "version": "0.1",
    "x-build-id": "yXdvYybr3sLR3acVM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/api-empire~linkedin-mass-company-profile-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~linkedin-mass-company-profile-finder/runs": {
      "post": {
        "operationId": "runs-sync-api-empire-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/api-empire~linkedin-mass-company-profile-finder/run-sync": {
      "post": {
        "operationId": "run-sync-api-empire-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": "🔍 Search Keywords, Domains & Brand Names (required)",
            "type": "array",
            "description": "📝 **What to enter:** Any list of search terms — domains (`alma.fr`), exact company names (`\"Acme Corp\"`), brand + qualifier (`\"Stripe\" payments`), or plain text. Each line is searched independently across the engines you select below.\n\n💡 **Tips:**\n• One keyword per line\n• Use quotes for exact-match phrases (`\"Stripe Inc\"`)\n• Bulk input fully supported — add 1, 10, or 1000+ keywords\n• Works with non-English brands and international domains",
            "items": {
              "type": "string"
            }
          },
          "engines": {
            "title": "🧭 Search Engines To Use",
            "type": "array",
            "description": "🎛️ **Which engines to run per keyword.** DuckDuckGo + Bing are enabled by default and give the most consistent coverage. Google is available as a supplemental **best-effort** option — it can widen coverage on hard-to-find companies but may return fewer results or be skipped under heavy load, so treat it as a bonus, not a primary source. Select any combination; an empty or invalid selection safely falls back to DuckDuckGo + Bing. Every output row records exactly which engines were attempted via `enginesTried`.",
            "items": {
              "type": "string",
              "enum": [
                "ddgs",
                "bing",
                "google"
              ],
              "enumTitles": [
                "DuckDuckGo (recommended, primary)",
                "Bing (recommended, primary)",
                "Google (best-effort, supplemental)"
              ]
            },
            "default": [
              "ddgs",
              "bing"
            ]
          },
          "maxResultsPerKeyword": {
            "title": "📊 Max Results Per Keyword",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "🔢 Maximum number of distinct LinkedIn company URLs to collect **per keyword**, combined across all selected engines. Higher values search deeper (more requests, more time) per keyword. Default: 30.",
            "default": 30
          },
          "maxConcurrency": {
            "title": "🧵 Concurrent Keywords (Workers)",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "⚙️ How many keywords are processed at the same time. Higher = faster runs but more request volume; lower = gentler and less likely to trigger a block. Default: 3.",
            "default": 3
          },
          "maxRetries": {
            "title": "🔁 Retries Per Engine On Failure",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "🔂 How many extra attempts each engine gets on a keyword before the actor escalates to the next proxy tier. Default: 2.",
            "default": 2
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}