{
  "openapi": "3.0.1",
  "info": {
    "title": "People Search Scraper for LinkedIn - By Job Title",
    "description": "Find people on LinkedIn by job title without a company list and without a login. Searches every way a role is written, opens each profile to confirm who they are, then filters by real location, employer and seniority. Independent tool, not affiliated with LinkedIn.",
    "version": "0.1",
    "x-build-id": "dJkM2TTgGJOdbYchY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapesage~linkedin-people-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapesage-linkedin-people-search-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/scrapesage~linkedin-people-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapesage-linkedin-people-search-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/scrapesage~linkedin-people-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapesage-linkedin-people-search-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": {
          "jobTitles": {
            "title": "Job titles",
            "type": "array",
            "description": "The roles you want, e.g. \"Head of Marketing\", \"Account Executive\", \"CFO\". Common titles work best. Each title is searched separately.",
            "items": {
              "type": "string"
            }
          },
          "expandTitleVariants": {
            "title": "Expand title variants (recommended)",
            "type": "boolean",
            "description": "Also search the equivalent ways the same role is written - \"Head of Marketing\" additionally finds VP Marketing, Marketing Director and CMO. This is where most of the volume comes from: a single phrasing returns roughly 20 people, eight variants returned 113 in testing. Turn it off if you want that exact wording only.",
            "default": true
          },
          "extraKeywords": {
            "title": "Extra context keywords",
            "type": "array",
            "description": "Optional words that must also appear, e.g. \"SaaS\", \"B2B\", \"fintech\". These add reach but are less precise than the title itself, so they are searched after the title variants.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations (filter)",
            "type": "array",
            "description": "Keep only people whose location matches one of these places, e.g. \"London\", \"United States\". Each place is also added to the web search to find more candidates there, and then checked on the person's own location, so nobody is kept just because a page mentioned the place. For a person whose profile does not open, the location comes from the search listing, which shows one for only about 1 person in 5, so in a run where LinkedIn opens no profile a location filter returns few people, or none for many city searches.",
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "Companies (filter)",
            "type": "array",
            "description": "Keep only people whose current employer matches one of these. Leave empty for any company. The employer comes from the person's profile, or from the search listing for a person whose profile does not open (about 6 people in 10 show one there). If you already know the companies and want everyone inside them, the Company Employees Scraper for LinkedIn is the better tool.",
            "items": {
              "type": "string"
            }
          },
          "seniorityLevels": {
            "title": "Seniority levels (filter)",
            "type": "array",
            "description": "Keep only these seniority levels, derived from each person's job title.",
            "items": {
              "type": "string",
              "enum": [
                "Owner/C-Level",
                "VP/Director",
                "Manager",
                "Senior",
                "Individual Contributor",
                "Entry"
              ]
            }
          },
          "verifyProfiles": {
            "title": "Verify profiles (recommended)",
            "type": "boolean",
            "description": "Open each person's public profile to confirm who they are and to collect location, current company, followers, education and the member-filled sections (languages, awards, organizations). Each run first reads a few profiles; when none of them opens and a well-known public profile does not open either (LinkedIn keeping profiles closed to logged-out visitors, as it did for this actor's residential reads from about 1 November 2026), it skips the checks, builds every person from the search engines' listing of their profile instead, and says so in the run's status message. Switched off, no profile is opened and every person comes from the listing.",
            "default": true
          },
          "requireTitleMatch": {
            "title": "Require title match (recommended)",
            "type": "boolean",
            "description": "Only return people whose title, as their profile or search listing shows it, matches what you searched for, including the equivalent phrasings, so searching \"Head of Marketing\" still keeps a CMO. The employer's name does not count as a match. Turn it off to see everyone the search surfaced, on-title or not; each row carries titleMatchesSearch either way.",
            "default": true
          },
          "includeUnverified": {
            "title": "Include unverified people",
            "type": "boolean",
            "description": "Also return people whose own profile does not open (many members hide it from logged-out visitors). They arrive with publicProfileAvailable false and only the fields the search listing shows: name, job title, headline, and often company and location. In a run where LinkedIn opens no profile at all, every person comes from the listing whatever this is set to.",
            "default": false
          },
          "maxPerTitle": {
            "title": "Max people per job title",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap per title, so one title cannot consume the whole run.",
            "default": 50
          },
          "maxResults": {
            "title": "Max results (whole run)",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Total cap across every title, shared out between the titles so each one gets its part (a title that finds fewer leaves the rest to the next). Set 0 for no limit (explicit opt-in).",
            "default": 100
          },
          "searchPages": {
            "title": "Search pages per query",
            "minimum": 1,
            "maximum": 4,
            "type": "integer",
            "description": "The fewest result pages read for each query. While a title still needs people a query is read up to 4 pages deep anyway, so raise this only to read every query to that depth. Pages beyond the first are best-effort.",
            "default": 1
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 15,
            "type": "integer",
            "description": "How many profiles to read in parallel.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Used for the LinkedIn profile pages. With the default (Apify Proxy, residential) each profile is asked on Apify's datacenter proxy first and on residential once when it is refused, which costs less and opens as many. Any other choice (a country, other groups, your own proxy URLs) is used exactly as given. The web search itself runs on datacenter proxies with no per-request fee.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}