{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Company Scraper: Hiring Signals & Posts (No Cookies)",
    "description": "LinkedIn company scraper that goes beyond the page: firmographics, open jobs and hiring signals (functions, seniority, countries, tech stack from job ads), posting activity, momentum score, change monitoring and a white-label PDF report. No cookies, no account. From $3 per 1,000 companies.",
    "version": "0.1",
    "x-build-id": "ZhFYYUmEiRyE4lT3e"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/meskaoui.azeddine~linkedin-company-intelligence/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-meskaoui.azeddine-linkedin-company-intelligence",
        "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/meskaoui.azeddine~linkedin-company-intelligence/runs": {
      "post": {
        "operationId": "runs-sync-meskaoui.azeddine-linkedin-company-intelligence",
        "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/meskaoui.azeddine~linkedin-company-intelligence/run-sync": {
      "post": {
        "operationId": "run-sync-meskaoui.azeddine-linkedin-company-intelligence",
        "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": "Companies",
            "type": "array",
            "description": "One company per line. Accepted: a LinkedIn company URL (<b>https://www.linkedin.com/company/odoo</b>), a website (<b>odoo.com</b>, the Actor follows the LinkedIn link found on the site), or a company name (<b>Odoo</b>, matched by handle and flagged as a guess).",
            "items": {
              "type": "string"
            }
          },
          "includeHiringSignals": {
            "title": "Hiring signals",
            "type": "boolean",
            "description": "Reads the open jobs of the company: how many, how many in the last 7 days, split by function, seniority and country, and the technologies named in the job ads. Charged as a separate event.",
            "default": true
          },
          "includeContentActivity": {
            "title": "Content activity",
            "type": "boolean",
            "description": "Analyses the latest posts shown on the company page: last post date, posts per week, average reactions and comments, best post. Included in the company profile, no extra charge.",
            "default": true
          },
          "maxJobsPerCompany": {
            "title": "Jobs listed per company",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "How many open jobs to list, most recent first. The total number of open jobs is always reported, whatever this limit. LinkedIn shows at most 1,000.",
            "default": 50
          },
          "jobAdsRead": {
            "title": "Job ads read in full",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "How many of the most recent job ads are opened to read seniority, contract type, salary and the technologies mentioned. More ads give a fuller technology list and take longer.",
            "default": 10
          },
          "jobsLocation": {
            "title": "Jobs location",
            "type": "string",
            "description": "Leave empty for jobs worldwide. Give a country or a city (<b>France</b>, <b>Berlin</b>) to count only the jobs there."
          },
          "includeJobList": {
            "title": "Include the list of jobs in the output",
            "type": "boolean",
            "description": "Turn off to keep only the totals and breakdowns.",
            "default": true
          },
          "includePostList": {
            "title": "Include the list of posts in the output",
            "type": "boolean",
            "description": "Turn off to keep only the activity figures and the best post.",
            "default": true
          },
          "monitorChanges": {
            "title": "Monitor changes between runs",
            "type": "boolean",
            "description": "Remembers each company and reports what moved since the previous run: new jobs, new posts, change in open jobs, employees and followers, edited profile fields. Schedule the Actor daily or weekly to get alerts.",
            "default": false
          },
          "onlyChangedCompanies": {
            "title": "Output only the companies that changed",
            "type": "boolean",
            "description": "With monitoring on, companies with no new job, no new post and no profile change are left out of the output. They are still read, so they are still charged.",
            "default": false
          },
          "monitorName": {
            "title": "Watchlist name",
            "type": "string",
            "description": "Use different names to keep separate watchlists (for example one per client). Runs with the same name compare against each other.",
            "default": "default"
          },
          "generateReport": {
            "title": "Generate a report per company (PDF and HTML)",
            "type": "boolean",
            "description": "A two to three page briefing of each company with your name and colour on it, ready to send to a client or to a sales team. Charged per report.",
            "default": false
          },
          "reportBrandName": {
            "title": "Your name or agency name on the report",
            "type": "string",
            "description": "Shown at the top right of every report. Leave empty for an unbranded report."
          },
          "reportBrandColor": {
            "title": "Report colour",
            "type": "string",
            "description": "A hex colour such as <b>#0a66c2</b>.",
            "default": "#0a66c2"
          },
          "maxConcurrency": {
            "title": "Companies read in parallel",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Lower it if many companies come back as blocked.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "LinkedIn refuses an address after a few dozen pages, so a proxy is required for more than a handful of companies. Blocked companies are reported as such and are not charged.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}