{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn People Search Scraper",
    "description": "Search LinkedIn for people by name, title, or keyword. Filter by location, company, school, or connection degree. Returns profile URLs, headlines, and contact details.",
    "version": "1.30",
    "x-build-id": "pgrzBO4MWgxsn0Bne"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~linkedin-people-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-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/crawlerbros~linkedin-people-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-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/crawlerbros~linkedin-people-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-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",
        "required": [
          "searchQuery",
          "cookie"
        ],
        "properties": {
          "searchQuery": {
            "title": "Search Query",
            "type": "string",
            "description": "Search keywords for finding people on LinkedIn. Examples: 'software engineer', 'John Smith', 'product manager Google'"
          },
          "keywords": {
            "title": "Extra Keywords",
            "type": "string",
            "description": "Optional companion to Search Query. When both are set, they are combined with a space. Use this to keep a primary role in Search Query and add modifiers (industry buzzwords, tools) here."
          },
          "cookie": {
            "title": "LinkedIn Cookie",
            "type": "string",
            "description": "Your LinkedIn session cookie. Accepts either: (1) the li_at value from browser DevTools → Application → Cookies, or (2) full cookies JSON array exported from an extension like EditThisCookie."
          },
          "location": {
            "title": "Location Filter",
            "type": "string",
            "description": "Filter results by location (city, state, or country). Example: 'San Francisco Bay Area', 'New York', 'United Kingdom'"
          },
          "currentCompany": {
            "title": "Current Company Filter",
            "type": "string",
            "description": "Filter by current company. Accepts a company name (e.g. 'Google') or a LinkedIn fsd_company URN/numeric ID. URN format produces the strict structured currentCompany filter; plain names are added to keywords."
          },
          "pastCompany": {
            "title": "Past Company Filter",
            "type": "string",
            "description": "Filter by past company. Accepts a company name or a LinkedIn fsd_company URN/numeric ID."
          },
          "school": {
            "title": "School Filter",
            "type": "string",
            "description": "Filter by school or university attended. Accepts a school name or a LinkedIn fsd_school URN/numeric ID. Example: 'Stanford University', 'MIT', or '12345'."
          },
          "firstNameKeyword": {
            "title": "First Name",
            "type": "string",
            "description": "Filter by first name token. Adds a strict firstName filter to the search."
          },
          "lastNameKeyword": {
            "title": "Last Name",
            "type": "string",
            "description": "Filter by last name token. Adds a strict lastName filter to the search."
          },
          "titleKeyword": {
            "title": "Job Title",
            "type": "string",
            "description": "Filter by current job title keyword (e.g. 'Director of Engineering', 'CTO'). Different from Industry / Job Function — this is the free-text title."
          },
          "serviceCategory": {
            "title": "Service Category",
            "type": "string",
            "description": "Filter by LinkedIn Services Marketplace category (e.g. 'Web Development', 'Marketing Strategy')."
          },
          "companyHeadcount": {
            "title": "Company Headcount",
            "type": "array",
            "description": "Filter by employer company size. A=Self-employed, B=1-10, C=11-50, D=51-200, E=201-500, F=501-1,000, G=1,001-5,000, H=5,001-10,000, I=10,001+.",
            "items": {
              "type": "string",
              "enum": [
                "A",
                "B",
                "C",
                "D",
                "E",
                "F",
                "G",
                "H",
                "I"
              ],
              "enumTitles": [
                "Self-employed",
                "1-10 employees",
                "11-50 employees",
                "51-200 employees",
                "201-500 employees",
                "501-1,000 employees",
                "1,001-5,000 employees",
                "5,001-10,000 employees",
                "10,001+ employees"
              ]
            }
          },
          "followerOf": {
            "title": "Followers of Company",
            "type": "string",
            "description": "Filter to people who follow a specific company. Accepts an fsd_company URN or numeric company ID."
          },
          "geoUrn": {
            "title": "Location URN",
            "type": "string",
            "description": "Precise location filter using a LinkedIn geo URN or numeric geo ID (e.g. '103644278' for the United States). Use this for strict geographic filtering instead of the free-text Location field."
          },
          "connectionDegree": {
            "title": "Connection Degree",
            "enum": [
              "",
              "F",
              "S",
              "O"
            ],
            "type": "string",
            "description": "Filter by connection degree to your account.",
            "default": ""
          },
          "industry": {
            "title": "Industry",
            "enum": [
              "",
              "Software Development",
              "Financial Services",
              "Healthcare",
              "Education",
              "Marketing and Advertising",
              "Consulting",
              "Hospitality",
              "Real Estate",
              "Manufacturing",
              "Retail",
              "Media",
              "Government Administration",
              "Non-profit Organization Management"
            ],
            "type": "string",
            "description": "Filter results by industry. Applied to both Voyager filters and the HTML search URL.",
            "default": ""
          },
          "seniorityLevel": {
            "title": "Seniority Level",
            "enum": [
              "",
              "Entry level",
              "Associate",
              "Mid-Senior level",
              "Director",
              "Executive"
            ],
            "type": "string",
            "description": "Filter results by seniority level.",
            "default": ""
          },
          "yearsOfExperience": {
            "title": "Years of Experience",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "5",
              "6"
            ],
            "type": "string",
            "description": "Filter results by years of total professional experience. 1=Less than 1 year, 2=1-2 years, 3=3-5 years, 4=6-10 years, 5=11-15 years, 6=16+ years.",
            "default": ""
          },
          "jobFunction": {
            "title": "Job Function",
            "enum": [
              "",
              "ARTS_AND_DESIGN",
              "BUSINESS_DEVELOPMENT",
              "COMMUNITY_AND_SOCIAL_SERVICES",
              "CONSULTING",
              "EDUCATION",
              "ENGINEERING",
              "ENTREPRENEURSHIP",
              "FINANCE",
              "HEALTHCARE_SERVICES",
              "HUMAN_RESOURCES",
              "INFORMATION_TECHNOLOGY",
              "LEGAL",
              "MANAGEMENT",
              "MARKETING",
              "MEDIA_AND_COMMUNICATION",
              "MILITARY_AND_PROTECTIVE_SERVICES",
              "OPERATIONS",
              "PRODUCT_MANAGEMENT",
              "PROGRAM_AND_PROJECT_MANAGEMENT",
              "PURCHASING",
              "QUALITY_ASSURANCE",
              "REAL_ESTATE",
              "RESEARCH",
              "SALES",
              "SUPPORT"
            ],
            "type": "string",
            "description": "Filter results by job function / department.",
            "default": ""
          },
          "openTo": {
            "title": "Open To",
            "type": "array",
            "description": "Filter people by what they are open to. Select one or more options. HIRING = open to hiring, GETTING_HIRED = open to new jobs, PROVIDING_SERVICES = open to providing freelance/consulting services, JOINING_A_NONPROFIT = open to joining a nonprofit.",
            "items": {
              "type": "string",
              "enum": [
                "HIRING",
                "GETTING_HIRED",
                "PROVIDING_SERVICES",
                "JOINING_A_NONPROFIT"
              ],
              "enumTitles": [
                "Open to Hiring",
                "Open to New Jobs",
                "Open to Providing Services",
                "Open to Joining a Nonprofit"
              ]
            }
          },
          "profileLanguages": {
            "title": "Profile Languages",
            "type": "array",
            "description": "Filter by the language(s) the person's LinkedIn profile is written in. Use ISO 639-1 codes, e.g. [\"en\", \"es\", \"fr\", \"de\", \"zh\", \"ar\", \"pt\"].",
            "items": {
              "type": "string"
            }
          },
          "contactOf": {
            "title": "Contact Of (Member URN or Profile ID)",
            "type": "string",
            "description": "Filter to show people who are connections of the specified LinkedIn member. Provide the member's URN (e.g. 'urn:li:member:123456') or numeric profile ID."
          },
          "talksAbout": {
            "title": "Talks About (Keyword / Topic)",
            "type": "string",
            "description": "Filter to people who talk about the specified keyword or topic in their profile. This is appended to the search keywords."
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum number of profiles to return.",
            "default": 25
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Optional Apify proxy configuration."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}