{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Company Search Scraper | Profiles & Firmographics",
    "description": "Search LinkedIn companies by keyword and export firmographics: industry, size, headquarters, founding year, website, specialties and follower counts. It also scrapes people profiles by keyword, name or URL in the same run. No login needed for public company data, in every market worldwide.",
    "version": "1.0",
    "x-build-id": "zosJSeLhRRtN2yuLu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~linkedin-profiles-companies-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-linkedin-profiles-companies-scraper",
        "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/silentflow~linkedin-profiles-companies-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-linkedin-profiles-companies-scraper",
        "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/silentflow~linkedin-profiles-companies-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-linkedin-profiles-companies-scraper",
        "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": {
          "action": {
            "title": "🎯 Action",
            "enum": [
              "get-profiles",
              "get-companies"
            ],
            "type": "string",
            "description": "Select an action to perform",
            "default": "get-profiles"
          },
          "keywords": {
            "title": "🔍 Query or list of queries (keywords, names..)",
            "type": "array",
            "description": "It can be a single query or a list of names, companies or URLS... ⚠️ For performance reason we limit to 500 keywords, over will be ignored",
            "default": [
              "web dev"
            ],
            "items": {
              "type": "string"
            }
          },
          "isUrl": {
            "title": "⚠️ Set if querying per URL",
            "type": "boolean",
            "description": "Must be set to true if querying per URL (https://linkedin.com/in/john-doe/) or false if querying per keyword or name (web developer)",
            "default": false
          },
          "limit": {
            "title": "🔢 Limit of result per query",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Max rows to return per query item. (If limit is 5 and keywords contains 2 items, will return 10 rows). Above 40, several searches are combined to cover more people, so a large number takes longer.",
            "default": 10
          },
          "fetchDetails": {
            "title": "📋 Fetch full profile details",
            "type": "boolean",
            "description": "When enabled, visits each LinkedIn profile page to get full details (headline, summary, company, etc.). Slower but more data. When disabled, only returns basic info from search results (faster).",
            "default": false
          },
          "cookies": {
            "title": "🔑 LinkedIn cookies (optional)",
            "type": "array",
            "description": "Optional. Paste your LinkedIn browser cookies as a JSON array to unlock complete, reliable personal-profile details (headline, current role, company, location, experience, education, skills). Without cookies the scraper still works using public data. Install Cookie-Editor, log into LinkedIn, Export as JSON, and paste here. Required cookies: li_at and JSESSIONID."
          },
          "userAgent": {
            "title": "🧭 User Agent (optional)",
            "type": "string",
            "description": "Optional. The User-Agent of the browser you used to export the cookies. Leave empty for automatic rotation.",
            "default": ""
          },
          "includeSkills": {
            "title": "🧩 Include skills",
            "type": "boolean",
            "description": "On by default. Turn off to skip fetching profile skills, which makes authenticated runs faster and cheaper when you only need experience, education and contact fields.",
            "default": true
          },
          "location": {
            "title": "🌍 Location",
            "type": "array",
            "description": "Filter by location",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "🏢 Companies",
            "type": "array",
            "description": "Only return people who work at these companies. Each company runs its own search and the results are checked against the employer on the profile, so the rows you get back are people confirmed at those companies. Requires \"Fetch full profile details\".",
            "items": {
              "type": "string"
            }
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Select proxies to be used.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}