{
  "openapi": "3.0.1",
  "info": {
    "title": "TruePeopleSearch Scraper: People, Phones & Emails",
    "description": "Search TruePeopleSearch by name, phone, address, email, link or CSV and get every person on every result page with all phones (type, carrier, dates), emails, current and past addresses with coordinates, relatives, associates, property, jobs and schools. Misses are free.",
    "version": "0.0",
    "x-build-id": "XxXGCQHiF9O0kd7UL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clearpath~truepeoplesearch-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clearpath-truepeoplesearch-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/clearpath~truepeoplesearch-scraper/runs": {
      "post": {
        "operationId": "runs-sync-clearpath-truepeoplesearch-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/clearpath~truepeoplesearch-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-clearpath-truepeoplesearch-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": "A full name, optionally followed by a place after a comma or a semicolon: 'John Smith', 'John Smith, Dallas, TX', 'John Smith; 75228'. A place needs its state or a ZIP.",
            "items": {
              "type": "string"
            }
          },
          "phones": {
            "title": "Phone numbers",
            "type": "array",
            "description": "A US phone number in any common format, for example '(214) 349-3972' or '+1 214 349 3972'. Returns the people the number is listed for.",
            "items": {
              "type": "string"
            }
          },
          "addresses": {
            "title": "Addresses",
            "type": "array",
            "description": "A street, then its city with a state, or a ZIP: '3828 Double Oak Ln, Irving, TX 75061' or '3828 Double Oak Ln; 75061'. Returns the people listed at that address.",
            "items": {
              "type": "string"
            }
          },
          "emails": {
            "title": "Email addresses",
            "type": "array",
            "description": "An email address. Returns the people it is listed for.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Maximum people for the whole run",
            "minimum": 0,
            "type": "integer",
            "description": "Stop once this many people have been returned across all searches. Each person returned is charged. Leave empty for no run-wide limit."
          },
          "maxResultsPerSearch": {
            "title": "Maximum people per search",
            "minimum": 1,
            "type": "integer",
            "description": "Stop each search after this many people. A common name can list hundreds of people over many pages. Leave empty to read every page. Both limits apply; a run stops at whichever is reached first."
          },
          "startUrls": {
            "title": "TruePeopleSearch links",
            "type": "array",
            "description": "TruePeopleSearch profile links ('https://www.truepeoplesearch.com/find/person/...') return that person; results links ('https://www.truepeoplesearch.com/results?name=...') run that search with all its pages. Links to other sites are refused.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searches": {
            "title": "Structured searches",
            "type": "array",
            "description": "A list of searches as objects, for callers that keep names and places in separate fields: {\"firstName\": \"John\", \"lastName\": \"Smith\", \"city\": \"Dallas\", \"state\": \"TX\"}, {\"phone\": \"2143493972\"}, {\"street\": \"3828 Double Oak Ln\", \"zip\": \"75061\"}, {\"email\": \"name@example.com\"}. Each object may also set ageMin and ageMax."
          },
          "csvUrl": {
            "title": "CSV or spreadsheet of people",
            "type": "string",
            "description": "Upload a CSV, or paste a public CSV or Google Sheets link. The first row names the columns: Name (or First Name and Last Name), City, State, ZIP, Address, Phone, Email. Each row is one search: its phone, else its email, else its address, else its name with its place; the row's name puts that person first in the results."
          },
          "ageMin": {
            "title": "Minimum age",
            "minimum": 0,
            "type": "integer",
            "description": "Only return people at least this old. Narrows name searches at the site itself, so a common name reaches further into its matches. People outside the band are not returned or charged. Off by default."
          },
          "ageMax": {
            "title": "Maximum age",
            "minimum": 0,
            "type": "integer",
            "description": "Only return people at most this old. Works like the minimum age."
          },
          "includeProfileDetails": {
            "title": "Read each person's full profile",
            "type": "boolean",
            "description": "On: every row carries the whole profile: all phones, emails, current and past addresses, relatives, associates, property, jobs and schools. Off: rows come from the result list only (name, age, city, past places, relatives' names, profile link), which is faster and charged at the lower per-result price."
          },
          "fillMissingContacts": {
            "title": "Complete people whose profile cannot be read",
            "type": "boolean",
            "description": "On: a person whose profile page cannot be read still comes back with phones, emails and addresses when they can be confirmed on name, age, city and relatives (detailLevel 'completed'). Off: that person comes back with what the result list shows (detailLevel 'summary')."
          },
          "wirelessOnly": {
            "title": "Mobile numbers only",
            "type": "boolean",
            "description": "Keep only numbers listed as Wireless. Landline and VoIP numbers are left out; a person with no mobile number still comes back, with no phones."
          },
          "includeEmails": {
            "title": "Include email addresses",
            "type": "boolean",
            "description": "Off: rows keep phones and everything else, with no email addresses."
          },
          "onlyWithContacts": {
            "title": "Only people with a phone or email",
            "type": "boolean",
            "description": "Leave out, and do not charge for, people with no phone number and no email address."
          },
          "flattenedOutput": {
            "title": "Spreadsheet columns",
            "type": "boolean",
            "description": "Add flat columns for spreadsheets and CRMs: Full Name, Age, Street Address, City, State, ZIP, Input Given, Person Link, Phone-1 to Phone-5 (each with Type, Provider and Last Reported) and Email-1 to Email-5."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Each person is POSTed here as JSON as soon as they are found, for Zapier, Make, n8n or your own endpoint. A webhook that fails never stops the run; every person is in the dataset either way."
          },
          "resumeCursor": {
            "title": "Resume cursor",
            "type": "string",
            "description": "Continue a run that stopped at a limit: paste the cursor its log printed and keep the same input. People already delivered are not delivered or charged again."
          },
          "maxConcurrency": {
            "title": "Maximum pages in parallel",
            "minimum": 1,
            "type": "integer",
            "description": "How many result and profile pages are fetched at once, across all searches. Lower it to slow the run down. Leave empty to size it to the run."
          },
          "demoMode": {
            "title": "Demo mode",
            "type": "boolean",
            "description": "Return one fictional sample row showing every field, without searching anything and without charge."
          },
          "feedback": {
            "title": "Feedback to the maintainers",
            "type": "string",
            "description": "For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}