{
  "openapi": "3.0.1",
  "info": {
    "title": "People Search by Name & Location: LinkedIn + Title $0.5795/1K",
    "description": "People search by name and location: find a person by name and city, region or country, worldwide, and get their LinkedIn profile, job title, company and town, plus a work email when we hold one. Business profiles only; each row shows how it matched. $0.5795 per 1,000 people found, misses free.",
    "version": "1.0",
    "x-build-id": "j53bbsM0whvLIb1uc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/bulkleads~people-search-by-name-and-location/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-bulkleads-people-search-by-name-and-location",
        "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/bulkleads~people-search-by-name-and-location/runs": {
      "post": {
        "operationId": "runs-sync-bulkleads-people-search-by-name-and-location",
        "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/bulkleads~people-search-by-name-and-location/run-sync": {
      "post": {
        "operationId": "run-sync-bulkleads-people-search-by-name-and-location",
        "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": {
          "people": {
            "title": "People",
            "type": "array",
            "description": "A list of { \"name\", \"location\" }: a first and last name, and a town, region or country (e.g. \"Austin, TX\", \"Leeds, UK\", \"Ontario\", \"Germany\"). The USA and 225 other countries."
          },
          "names": {
            "title": "Or names, one per line",
            "type": "array",
            "description": "Lines like \"Jane Doe; Austin, TX\" (the place after a semicolon), or just names with the one location below.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Location for names without one",
            "type": "string",
            "description": "A town, region or country used for every name above that has no place of its own (optional)."
          },
          "maxPerName": {
            "title": "Max people per name",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "People with that name in that place, the best kept records first. Each one is charged.",
            "default": 5
          },
          "onlyUnique": {
            "title": "Only the one person with that name",
            "type": "boolean",
            "description": "On: a name is returned only when one person with that name is in that place; names shared by several people come back as a free row with status ambiguous. Off: same-name people are returned too, marked ambiguous.",
            "default": false
          },
          "findMissingEmails": {
            "title": "Find emails for profiles with none",
            "type": "boolean",
            "description": "Profiles found with no email, or one that failed our check, get a work email found by LinkedIn Email Finder before delivery. Charged by it at its own price, per email found.",
            "default": false
          },
          "checkEmails": {
            "title": "Check emails not checked yet",
            "type": "boolean",
            "description": "Before delivery, any email our checker has not checked in the last 90 days is checked now by our Bulk Email Verifier, and the profile shows the answer. Charged by Bulk Email Verifier at its own price, per email with a clear answer.",
            "default": false
          },
          "emailThemNow": {
            "title": "Email these people now",
            "type": "boolean",
            "description": "Also sends each person found a first email and one follow-up, written for them from your website and sent now from warmed-up inboxes, by Cold Email Sender. Charged by it at its own price, per person emailed. Replies come to the address below; the first time, you confirm it with one click.",
            "default": false
          },
          "coldEmailAsk": {
            "title": "What you want from them",
            "type": "string",
            "description": "For Email these people now: the ask, e.g. a 15-minute call. It is put in our own words; links and text pasted here are never copied into the emails."
          },
          "coldEmailReplyTo": {
            "title": "Where replies go",
            "type": "string",
            "description": "For Email these people now: real replies are forwarded here."
          },
          "coldEmailWebsite": {
            "title": "Your website",
            "type": "string",
            "description": "For Email these people now: what you sell is read from it. Leave empty when the reply address is at your company domain."
          },
          "coldEmailPreview": {
            "title": "Only write the emails (preview)",
            "type": "boolean",
            "description": "For Email these people now: writes the emails for the first 10 people and sends nothing. Free.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}