{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Company URL - Mass Profile Finder: Executive Contacts",
    "description": "LinkedIn Company URL Mass Profile Finder — Find company profiles in bulk from LinkedIn URLs and extract executive names, job titles, company details, LinkedIn profiles, and publicly available contact data. Build targeted executive lead lists for B2B prospecting and research.",
    "version": "0.1",
    "x-build-id": "91gckspkdRegGcg8N"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/simpleapi~linkedin-company-url-mass-profile-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~linkedin-company-url-mass-profile-finder/runs": {
      "post": {
        "operationId": "runs-sync-simpleapi-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/simpleapi~linkedin-company-url-mass-profile-finder/run-sync": {
      "post": {
        "operationId": "run-sync-simpleapi-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",
        "required": [
          "companies"
        ],
        "properties": {
          "companies": {
            "title": "🏢 Target Companies",
            "type": "array",
            "description": "One company per line — a name (<code>Stripe</code>), a LinkedIn company URL, or a slug. Each company yields its LinkedIn page and its executive contacts. ✨",
            "items": {
              "type": "string"
            }
          },
          "findDecisionMakers": {
            "title": "🎯 Discover executive contacts",
            "type": "boolean",
            "description": "When ON, mine public search for each company's leadership (C-level / VP / Director / Founder / Owner) and emit them as contact rows keyed to the company.",
            "default": true
          },
          "titleAllowList": {
            "title": "🧑‍💼 Leadership Titles (search + filter)",
            "type": "array",
            "description": "Job titles to search for AND to filter contacts by (case-insensitive). A contact is kept only if its name/headline contains one of these. Leave default for a broad C-suite sweep. Example: <code>CEO</code>, <code>Head of Marketing</code>.",
            "items": {
              "type": "string"
            }
          },
          "maxContactsPerCompany": {
            "title": "👥 Max contacts per company",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Upper bound on executive-contact rows emitted per company. 0 = unlimited. This caps CHILDREN only — every company still gets its own parent row. Default 10.",
            "default": 10
          },
          "resolveEmails": {
            "title": "📧 Best-effort work email",
            "type": "boolean",
            "description": "When ON, attach a best-effort work email to each contact: a SERP-found address on the company domain (emailStatus=serp_found) or a domain pattern guess like first.last@company.com (emailStatus=pattern_guess). Coverage is HONESTLY low (~0–10%) — guesses are labelled as guesses and never presented as verified; empty when no domain/name. Default ON.",
            "default": true
          },
          "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 lookups. <code>us-en</code> returns English result titles.",
            "default": "us-en"
          },
          "maxConcurrency": {
            "title": "⚡ Speed (concurrent companies)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many companies are processed in parallel. Higher = faster, but uses the proxy pool quicker. 🏎️",
            "default": 10
          },
          "querySuffix": {
            "title": "🧲 Company-lookup Suffix",
            "type": "string",
            "description": "Phrase appended to each company name to surface its LinkedIn company page. Leave the default unless you know what you're doing. 🛠️",
            "default": "linkedin company"
          },
          "includeNotFound": {
            "title": "📭 Include \"not found\" companies",
            "type": "boolean",
            "description": "When ON, companies with no LinkedIn page still get a parent row (empty URL) so your output lines up 1-to-1 with your input.",
            "default": true
          },
          "requestTimeout": {
            "title": "⏱️ Request timeout (seconds)",
            "minimum": 5,
            "maximum": 120,
            "type": "integer",
            "description": "Per-request timeout in seconds. Default 20.",
            "default": 20
          },
          "retryBackoff": {
            "title": "📉 Retry backoff multiplier",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Base multiplier for the exponential backoff between retries. Default 1 (≈1.5s base internally).",
            "default": 1
          },
          "maxRetries": {
            "title": "🔁 Max retries per request",
            "minimum": 1,
            "maximum": 12,
            "type": "integer",
            "description": "How many times a blocked/throttled request is retried on a fresh proxy IP before giving up. Default 6.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy Configuration",
            "type": "object",
            "description": "By default the Actor runs with NO proxy. If search blocks a request, it automatically falls back to Datacenter, then Residential — 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}