{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn People Search Scraper",
    "description": "Find public LinkedIn people by job title, company, school, location or keywords, one row per person with name, headline, company and profile URL. Optional enrichment adds About, work history and follower count. No login or cookies.",
    "version": "0.1",
    "x-build-id": "xxLbtwGWtoVluMoKt"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~linkedin-people-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~linkedin-people-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-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/khadinakbar~linkedin-people-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-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": {
          "jobTitle": {
            "title": "Job title",
            "type": "string",
            "description": "Job title to search for, quoted as a phrase on Google (e.g. 'Head of Growth'). Use this when sourcing people by role. Combine with location/company/school to narrow. NOT a free-text bio search — for that use the keywords field."
          },
          "seniority": {
            "title": "Seniority",
            "enum": [
              "",
              "Founder / Owner",
              "C-level",
              "VP",
              "Director",
              "Manager",
              "Senior",
              "Entry level"
            ],
            "type": "string",
            "description": "Seniority level added to the Google search as matching words (e.g. Director = 'Director' or 'Head of'). Works from the title text on public profiles, so it is best-effort. NOT LinkedIn's logged-in seniority filter.",
            "default": ""
          },
          "jobFunction": {
            "title": "Job function",
            "enum": [
              "",
              "Engineering",
              "Sales",
              "Marketing",
              "Product",
              "Operations",
              "Finance",
              "Human Resources",
              "Design",
              "Data",
              "Customer Success",
              "Legal",
              "Consulting"
            ],
            "type": "string",
            "description": "Department or function word added to the search (e.g. Marketing, Sales, Engineering). Best-effort text match on public profile titles. NOT a LinkedIn function ID.",
            "default": ""
          },
          "industry": {
            "title": "Industry",
            "type": "string",
            "description": "Industry word or phrase added to the search (e.g. 'fintech', 'healthcare'). Best-effort text match against public profile text. NOT a LinkedIn industry code."
          },
          "firstName": {
            "title": "First name",
            "type": "string",
            "description": "Person's first name for name lookups (e.g. 'Satya'). Use with last name for an exact-name search. NOT a full-name field and NOT an email."
          },
          "lastName": {
            "title": "Last name",
            "type": "string",
            "description": "Person's last name for name lookups (e.g. 'Nadella'). Use with first name for an exact-name search. NOT a full-name field and NOT an email."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, region, or country to filter people by (e.g. 'San Francisco' or 'Germany'). Matched against the public profile's location text in Google results. Leave empty for worldwide. NOT a postal code."
          },
          "currentCompany": {
            "title": "Company",
            "type": "string",
            "description": "Company name to filter people by (e.g. 'Stripe'). Quoted as a phrase so Google matches it exactly. Best-effort — LinkedIn public pages do not always expose the current employer. NOT a company LinkedIn URL."
          },
          "school": {
            "title": "School / university",
            "type": "string",
            "description": "School or university name to filter alumni (e.g. 'Stanford University'). Quoted as a phrase on Google. Useful for alumni sourcing. NOT a degree or field of study."
          },
          "keywords": {
            "title": "Free-text keywords",
            "type": "string",
            "description": "Extra free-text keywords added to the Google query (e.g. 'fintech founder'). Supports Google operators. Use alongside or instead of the structured filters. NOT a LinkedIn profile URL."
          },
          "excludeKeywords": {
            "title": "Exclude words",
            "type": "array",
            "description": "Words or phrases to leave out of results (up to 10), e.g. 'recruiter', 'student'. Each is added to the Google search as a minus term. NOT a list of profile URLs to skip.",
            "items": {
              "type": "string"
            }
          },
          "profileUrls": {
            "title": "Direct profile URLs (skip search)",
            "type": "array",
            "description": "Optional list of LinkedIn personal-profile URLs (https://www.linkedin.com/in/<slug>). When provided, search is skipped and these profiles are enriched directly. Use this when you already have URLs and just want full public data. NOT company or post URLs.",
            "items": {
              "type": "string"
            }
          },
          "enrichProfiles": {
            "title": "Deep profile enrichment",
            "type": "boolean",
            "description": "When true (default), each found profile is fetched for full public data: About section, work history with company links, education entries and follower count. When false, only the fast search-level fields (name, headline, location, URL) are returned at the lower price. Enrichment is billed per profile.",
            "default": true
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of people to return (1-1000). Caps both search depth and total cost. Defaults to 50. Very large lists depend on how deep Google's index goes for your filters, so a narrow search can return fewer. In direct-URL mode it caps how many of the supplied URLs are processed. Free Apify plan runs return up to 50 results per run.",
            "default": 50
          },
          "skipFirst": {
            "title": "Skip first N people",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Skip the first N people found so you can continue a big list in a later run (0-5000). Skipped people are not returned or charged. Use the same filters as the earlier run.",
            "default": 0
          },
          "resultsRegion": {
            "title": "Google region",
            "type": "string",
            "description": "Two-letter country code for the Google search region (e.g. 'US', 'GB', 'DE'). Affects which localized results surface. Defaults to 'US'. NOT the person's location filter — use the location field for that.",
            "default": "US"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}