{
  "openapi": "3.0.1",
  "info": {
    "title": "TruePeopleSearch — People Search Scraper",
    "description": "Scrape US people from TruePeopleSearch by name, phone or address. Each row: full phone numbers, emails, current + past addresses with geo, relatives, associates, aliases, age and property details (beds, baths, value, year built). Bulk lists, CSV & webhook. JSON or CSV out.",
    "version": "1.0",
    "x-build-id": "vm0EryJUcAskSSKL2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~truepeoplesearch-people-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-truepeoplesearch-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/memo23~truepeoplesearch-people-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-truepeoplesearch-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/memo23~truepeoplesearch-people-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-truepeoplesearch-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": {
          "names": {
            "title": "Names",
            "type": "array",
            "description": "Fill any combination of names, phones, addresses and emails — each value becomes one search and may return several matched people. Full names to look up. Optionally append a location after a comma to narrow results, e.g. \"Jane Doe, Irving, TX\" or \"John Smith, 75060\". TruePeopleSearch covers US records only and needs a state or ZIP with a city, so a name whose location has neither (\"Cebu\", \"Toronto, ON\") is skipped without a search or a charge.",
            "items": {
              "type": "string"
            }
          },
          "phones": {
            "title": "Phone numbers (reverse lookup)",
            "type": "array",
            "description": "US phone numbers in any format — \"(972) 917-9873\", \"972-917-9873\", \"+1 972 917 9873\". Returns the likely owner and their full record.",
            "items": {
              "type": "string"
            }
          },
          "addresses": {
            "title": "Addresses (reverse lookup)",
            "type": "array",
            "description": "Street addresses with city, state and ZIP, e.g. \"935 Turtle Cv, Irving, TX 75060\". Returns the people associated with the address.",
            "items": {
              "type": "string"
            }
          },
          "emails": {
            "title": "Email addresses (reverse lookup)",
            "type": "array",
            "description": "Email addresses to look up on TruePeopleSearch, e.g. \"jane@example.com\".",
            "items": {
              "type": "string"
            }
          },
          "flattenedOutput": {
            "title": "Flattened spreadsheet columns (Email-1, Phone-1, …)",
            "type": "boolean",
            "description": "When enabled, each row also gets CRM-style columns (`Email-1`…`Email-5`, `Phone-1`…`Phone-5` with `Phone-1 Type` (Wireless / Landline / Voip), `Phone-1 Provider` and `Phone-1 Last Reported`, `Street Address`, `Input Given`, `Person Link`) so a CSV export drops into Sheets the same way skip-trace tools do. Nested arrays stay on the row.",
            "default": false
          },
          "wirelessOnly": {
            "title": "Wireless numbers only",
            "type": "boolean",
            "description": "When enabled, each person's `phones`, `phoneDetails` and `primaryPhone` (and the `Phone-1`… columns) carry only the numbers TruePeopleSearch labels Wireless. Landline and VoIP numbers are left out and are not charged. A person with no wireless number is still returned, with an empty phone list.",
            "default": false
          },
          "includeEmails": {
            "title": "Include emails",
            "type": "boolean",
            "description": "On by default. When off, each row keeps phones and the rest of the record but `emails` (and the `Email-1`… columns) are empty, and those addresses are not charged.",
            "default": true
          },
          "fillMissingContacts": {
            "title": "Fill missing phones and emails",
            "type": "boolean",
            "description": "On by default. When a person's full TruePeopleSearch record cannot be loaded, look the same person up in another public people-search source and fill in their phones and emails. A match is used only when name, age, city and relatives agree; otherwise the row keeps the search-page summary without contacts. Rows filled this way have `contactsSource` set to `secondary`. Turn off to receive TruePeopleSearch data only.",
            "default": true
          },
          "resumeCursor": {
            "title": "Resume cursor",
            "type": "string",
            "description": "Paste the cursor from a previous run (logged as RESUME_CURSOR and saved in the key-value store) to continue without fetching or billing people you already received. Leave empty for a fresh crawl."
          },
          "startUrls": {
            "title": "Direct TruePeopleSearch URLs",
            "type": "array",
            "description": "Direct truepeoplesearch.com URLs to scrape as-is.",
            "items": {
              "type": "string"
            }
          },
          "csvUrl": {
            "title": "Bulk CSV URL",
            "type": "string",
            "description": "Link to a raw CSV whose header names Name / Phone / Address / Email columns (City/State/Zip fold into the name). Each row's cells become lookups. A Google Sheets link works when the sheet is shared with anyone who has the link. If the file cannot be read and there is no other input, the run ends without searching."
          },
          "webhookUrl": {
            "title": "CRM webhook URL (Zapier / Make / GoHighLevel)",
            "type": "string",
            "description": "Each person record is HTTP POSTed here as JSON as soon as it's found. Best-effort; a failed webhook never fails the run."
          },
          "demoMode": {
            "title": "Demo mode (one sample record, no lookup)",
            "type": "boolean",
            "description": "Return a single sample record so you can see the exact output format without running a lookup. The sample row is billed as one person record; no search, phone or email events are charged.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum people for the whole run",
            "minimum": 1,
            "type": "integer",
            "description": "Stop the run after this many person records across every name, phone, address and email. This is the hard cap: a per-search limit never lets the run go past it. You are billed per record, and per search that TruePeopleSearch runs, found or not.",
            "default": 10000
          },
          "maxItemsPerSearch": {
            "title": "Maximum people per search",
            "minimum": 1,
            "type": "integer",
            "description": "Stop each name / phone / address / email after this many people, then move to the next lookup. Both caps apply: 10 per search and 25 for the run means at most 25 people total.",
            "default": 10000
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "type": "integer",
            "description": "How many pages (searches and profiles) to fetch in parallel.",
            "default": 3
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}