{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn People Search — 16 Filters ✅ $1.50/1k, No Login",
    "description": "LinkedIn people search across 800M+ professional profiles: filter by job title, seniority, employer, size, industry, past employer and city. $1.50 per 1,000 people delivered — never per search; full profiles $3.20, with emails and phones $8. Require email, phone or GitHub; the rest are skipped free.",
    "version": "0.1",
    "x-build-id": "uyVyxxlMz70CDOPwd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/b2bsearch~people-database-search/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-b2bsearch-people-database-search",
        "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/b2bsearch~people-database-search/runs": {
      "post": {
        "operationId": "runs-sync-b2bsearch-people-database-search",
        "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/b2bsearch~people-database-search/run-sync": {
      "post": {
        "operationId": "run-sync-b2bsearch-people-database-search",
        "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": [
          "countries"
        ],
        "properties": {
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter country codes (us, de, gb...). At most 5 per run.",
            "items": {
              "type": "string"
            }
          },
          "titleKeywords": {
            "title": "Job title keywords",
            "type": "array",
            "description": "Match any of these words in the current job title (founder, cto, \"vice president\"...). Each 3-64 characters, at most 10.",
            "items": {
              "type": "string"
            }
          },
          "companyDomains": {
            "title": "Employer site domains",
            "type": "array",
            "description": "Keep only people currently working at companies with these site domains. At most 200.",
            "items": {
              "type": "string"
            }
          },
          "seniority": {
            "title": "Seniority",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only people whose current role falls in these seniority buckets. Buckets are assigned from the job title, so they work across title spellings ('CTO', 'Chief Technology Officer', 'Head of Technology' all land in cxo). At most 6.",
            "items": {
              "type": "string",
              "enum": [
                "cxo",
                "vp",
                "director",
                "manager",
                "founder",
                "other"
              ],
              "enumTitles": [
                "C-level (CxO)",
                "VP",
                "Director",
                "Manager",
                "Founder",
                "Other / individual contributor"
              ]
            }
          },
          "maxResults": {
            "title": "Maximum result rows",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Stop after this many people (default 500, maximum 50,000). You pay per person delivered — $1.50 per 1,000 in the row tier — so set it to the number you need.",
            "default": 500
          },
          "previewOnly": {
            "title": "Free preview: count only",
            "type": "boolean",
            "description": "Answer with the number of matching people instead of the rows. Free — run it first to size a segment before you buy. Off by default: a run returns rows.",
            "default": false
          },
          "profileDetail": {
            "title": "How much to return per person",
            "enum": [
              "row",
              "profile",
              "contacts"
            ],
            "type": "string",
            "description": "You pay per person delivered, never per search. row = name, title, employer, location and email flags, $1.50 per 1,000; profile = the full career profile, $3.20 per 1,000; contacts = the profile plus emails and phones, $8 per 1,000 people with a contact that reaches them today (the rest at the profile price). Profile tiers cap a run at 10,000.",
            "default": "row"
          },
          "mustHave": {
            "title": "Must have",
            "uniqueItems": true,
            "type": "array",
            "description": "Deliver and charge only people who have all of these; the rest are skipped for free and counted in one note row. Personal and work email work on every tier; social profiles need the full profile; phone and \"work email at the current employer\" need emails & phones. The free preview count does not apply this list.",
            "items": {
              "type": "string",
              "enum": [
                "email",
                "personalEmail",
                "workEmail",
                "currentWorkEmail",
                "phone",
                "github",
                "twitter",
                "facebook"
              ],
              "enumTitles": [
                "Any email address",
                "Personal email (gmail, yahoo, ISP mail)",
                "Work email (any company address)",
                "Work email at the current employer",
                "Direct phone (not a switchboard)",
                "GitHub profile",
                "Twitter / X profile",
                "Facebook profile"
              ]
            }
          },
          "compact": {
            "title": "Compact rows (for AI agents)",
            "type": "boolean",
            "description": "Returns a short row instead of the full record: identity, current role, location, the 5 latest positions, education, top skills and any contacts — about 2 KB per person instead of 10+ KB. Made for AI agents and LLM pipelines with a context limit. Same price. Off by default: a run returns the complete record.",
            "default": false
          },
          "headlineKeywords": {
            "title": "Headline keywords",
            "type": "array",
            "description": "Match any of these words in the profile headline. Each 3-64 characters, at most 10.",
            "items": {
              "type": "string"
            }
          },
          "pastTitleKeywords": {
            "title": "Past job title keywords",
            "type": "array",
            "description": "Match any of these words in a PAST job title — people who used to be something. 3-64 characters each, at most 10.",
            "items": {
              "type": "string"
            }
          },
          "excludeTitleKeywords": {
            "title": "Exclude job title keywords",
            "type": "array",
            "description": "Drop people whose current title contains any of these words (example: junior, assistant, intern). 3-64 characters each, at most 10.",
            "items": {
              "type": "string"
            }
          },
          "excludeHeadlineKeywords": {
            "title": "Exclude headline keywords",
            "type": "array",
            "description": "Drop people whose headline contains any of these words (example: student, retired, freelance). 3-64 characters each, at most 10.",
            "items": {
              "type": "string"
            }
          },
          "pastEmployerDomains": {
            "title": "Past employer site domains",
            "type": "array",
            "description": "Keep only people who USED to work at these companies — give site domains (stripe.com), they are resolved to employers for you. Pair with 'left after year' to find recent leavers. At most 20.",
            "items": {
              "type": "string"
            }
          },
          "leftPastEmployerAfterYear": {
            "title": "Left the past employer after year",
            "minimum": 1990,
            "maximum": 2100,
            "type": "integer",
            "description": "Only counts with 'Past employer site domains': keep people whose last day there falls in this year or later."
          },
          "stillThereCounts": {
            "title": "Count people who are still at the past employer",
            "type": "boolean",
            "description": "Off by default. A past employer match means a completed position there — and an internal promotion also closes one, so roughly a third of matches are people who never left (measured: 668 of 2,102 on one employer). By default those are dropped and you get actual leavers; turn this on to keep everyone who ever held a role there.",
            "default": false
          },
          "localityKeywords": {
            "title": "City / locality keywords",
            "type": "array",
            "description": "Narrow inside the chosen countries by city or region text (example: san francisco, greater london). 3-64 characters each, at most 10.",
            "items": {
              "type": "string"
            }
          },
          "employerIndustries": {
            "title": "Employer industries",
            "type": "array",
            "description": "Keep only people whose current employer is in these industries. Industry names, case-insensitive, in either the current or the older wording (Software Development also finds Computer Software) — examples: Software Development, IT Services and IT Consulting, Financial Services, Hospitals and Health Care, Advertising Services.",
            "items": {
              "type": "string"
            }
          },
          "employeeCountMin": {
            "title": "Employer size — minimum headcount",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only people at employers with at least this many employees."
          },
          "employeeCountMax": {
            "title": "Employer size — maximum headcount",
            "minimum": 1,
            "type": "integer",
            "description": "Keep only people at employers with at most this many employees."
          },
          "excludeLowSignal": {
            "title": "Skip low-signal profiles",
            "type": "boolean",
            "description": "Drop people with under 10 connections and no known career start — the self-declared \"CEO at <famous brand>\" pattern. Off by default: across the whole database many such profiles are sparse but real, so turn it on for leadership searches at well-known companies. Every row carries the lowSignal column either way.",
            "default": false
          },
          "connectionsMin": {
            "title": "Minimum connections",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only people with at least this many connections — a rough proxy for an active, established profile."
          },
          "careerStartYearMin": {
            "title": "Career started in or after",
            "minimum": 1950,
            "maximum": 2100,
            "type": "integer",
            "description": "Year of the person's first recorded position. Use with 'career started in or before' to target experience bands (a 2015 start is roughly 10 years of experience)."
          },
          "careerStartYearMax": {
            "title": "Career started in or before",
            "minimum": 1950,
            "maximum": 2100,
            "type": "integer",
            "description": "Year of the person's first recorded position."
          },
          "currentRoleStartedAfterYear": {
            "title": "Started the current role in or after",
            "minimum": 1990,
            "maximum": 2100,
            "type": "integer",
            "description": "Recent job changers: keep only people whose current position began in this year or later."
          },
          "requireCurrentPosition": {
            "title": "Only people with a current position on record",
            "type": "boolean",
            "description": "Drop rows where no current employer is known.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}