{
  "openapi": "3.0.1",
  "info": {
    "title": "FamilyTreeNow Scraper - Relatives, Phones & Addresses",
    "description": "Search FamilyTreeNow.com by name, phone or street address and get one row per person: age, birth month, phones with line type and carrier, emails, current and past addresses with dates, every relative and associate with ages, work history and the home property record. No login needed.",
    "version": "0.0",
    "x-build-id": "6rZ7agr0H6jHy7Ejg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~familytreenow-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-familytreenow-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~familytreenow-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-familytreenow-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~familytreenow-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-familytreenow-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. Use it with Last name; City and State (or a ZIP code) narrow the results."
          },
          "lastName": {
            "title": "Last name",
            "type": "string",
            "description": "Last name of the person."
          },
          "middleName": {
            "title": "Middle name",
            "type": "string",
            "description": "Optional middle name or initial. Leave empty unless the first and last name return too many people."
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Optional. Narrows a name search to one city (needs State). Used with State for an address lookup."
          },
          "state": {
            "title": "State",
            "enum": [
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY"
            ],
            "type": "string",
            "description": "Two-letter US state. Narrows a name search; used with City for an address lookup."
          },
          "phone": {
            "title": "Phone number (reverse lookup)",
            "type": "string",
            "description": "Find who a US phone number belongs to. Any format works, e.g. (214) 708-6530. When filled, this lookup runs instead of the name search."
          },
          "address": {
            "title": "Street address (who lives here)",
            "type": "string",
            "description": "Find the people linked to a street address, e.g. 177 Cynthia Dr. Needs City and State, or a ZIP code. When filled (and no phone is given), this lookup runs instead of the name search."
          },
          "zip": {
            "title": "ZIP code",
            "type": "string",
            "description": "Optional 5-digit ZIP code. Narrows a name search on its own, or completes an address lookup."
          },
          "birthYear": {
            "title": "Birth year",
            "minimum": 1900,
            "maximum": 2026,
            "type": "integer",
            "description": "Optional. Keeps people born in that year."
          },
          "searches": {
            "title": "Lookups list",
            "type": "array",
            "description": "One object per lookup, each with the same fields as above: {\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"city\":\"Austin\",\"state\":\"TX\"}, {\"phone\":\"2147086530\"} or {\"address\":\"123 Main St\",\"city\":\"Austin\",\"state\":\"TX\"}. A full name in \"name\" and \"middleName\", \"zip\" and \"birthYear\" also work. When set, it replaces the single lookup above. Up to 1,000 lookups per run on a paid plan."
          },
          "maxItemsPerSearch": {
            "title": "People per lookup",
            "minimum": 1,
            "type": "integer",
            "description": "Most people kept from each lookup. Defaults to 3 when you run more than one search, so a common name does not use up the whole run. Person links are one person each and do not count."
          },
          "startUrls": {
            "title": "Links",
            "type": "array",
            "description": "FamilyTreeNow search result pages or person record pages.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "openProfiles": {
            "title": "Full person records",
            "type": "boolean",
            "description": "On: opens each person's record for every phone number (with line type, carrier, last-reported date and primary flag), emails, current address with county and dates, past addresses, all relatives and associates with ages, other names, work history, businesses and the home's property record. Off: faster rows with name, age, birth month, city, past cities and some relatives only.",
            "default": true
          },
          "flattenedOutput": {
            "title": "Spreadsheet columns",
            "type": "boolean",
            "description": "Adds flat columns (Email-1 to Email-5, Phone-1 to Phone-5 with type, carrier and last-reported date, Street Address, City, State, Postal Code) next to the nested fields, for CSV and Excel exports.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum people",
            "minimum": 1,
            "type": "integer",
            "description": "Most people returned by the run. One run returns at most 3,000 (25 on the free Apify plan).",
            "default": 10
          },
          "maxConcurrency": {
            "title": "Parallel pages",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many pages load at the same time.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}