{
  "openapi": "3.0.1",
  "info": {
    "title": "SearchPeopleFree Scraper - People Search: Phones & Emails",
    "description": "Search SearchPeopleFree.com by name, state and city, or run 1,000 name searches at once. Each row is one person with every phone number and line type, full email addresses, current and past addresses with dates, relatives, spouse, associates, aliases, age and work history. Export JSON or CSV.",
    "version": "0.0",
    "x-build-id": "lr8qQIUScRMEk0rsm"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~searchpeoplefree-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-searchpeoplefree-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/memo23~searchpeoplefree-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-searchpeoplefree-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/memo23~searchpeoplefree-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-searchpeoplefree-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": {
          "firstName": {
            "title": "First name",
            "type": "string",
            "description": "First name of the person."
          },
          "lastName": {
            "title": "Last name",
            "type": "string",
            "description": "Last name of the person."
          },
          "state": {
            "title": "State",
            "type": "string",
            "description": "US state, two-letter code or full name (TX or Texas). Optional, but it narrows a common name a lot."
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "City within the state. Optional; needs a state."
          },
          "matchFirstName": {
            "title": "Only people with that first name",
            "type": "boolean",
            "description": "On: when SearchPeopleFree has nobody with the first name you searched, it lists other people who share the last name; those are skipped and not charged. A person counts as a match when their name or an alias has your first name (Rob also matches Robert, Chris also matches Christopher). Off: every person the site lists is returned. Applies to name searches and results-page links.",
            "default": true
          },
          "searches": {
            "title": "Name searches",
            "type": "array",
            "description": "One object per person to look up, each with firstName, lastName and optionally state and city. When this list is set it replaces the single search above. Up to 1,000 lookups per run. Example: [{\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"state\":\"CA\",\"city\":\"San Diego\"},{\"firstName\":\"Robert\",\"lastName\":\"Brown\",\"state\":\"FL\"}]"
          },
          "startUrls": {
            "title": "SearchPeopleFree links",
            "type": "array",
            "description": "Name search links (https://www.searchpeoplefree.com/find/john-smith/tx/austin, later pages too) or person links (https://www.searchpeoplefree.com/find/john-smith/259sXBk9IUq0). When set, these replace the searches above.",
            "items": {
              "type": "string"
            }
          },
          "includeContactDetails": {
            "title": "Open each person's full record",
            "type": "boolean",
            "description": "On: every person gets their full record with all phone numbers and line types, full email addresses, street addresses with dates, every relative and associate, and work history. Off: rows hold only what the results list shows (name, age, city, past cities, some relatives) and cost less. A person link is always read as a full record.",
            "default": true
          },
          "maxItems": {
            "title": "Maximum people",
            "minimum": 1,
            "maximum": 3000,
            "type": "integer",
            "description": "Most people returned by the run (at most 3,000). Common names can match hundreds of people.",
            "default": 10
          },
          "maxItemsPerSearch": {
            "title": "Maximum people per search",
            "minimum": 1,
            "type": "integer",
            "description": "Most people kept for each name search. Left empty with several searches, each search gets an even share of Maximum people, and a search that finds fewer passes its unused share on to the searches after it, so one common name cannot use up the whole run."
          },
          "maxConcurrency": {
            "title": "Parallel person records",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many full records are opened at the same time (1 to 10).",
            "default": 5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}