{
  "openapi": "3.0.1",
  "info": {
    "title": "Skip Trace Property Owner — Phone, Email & Address Finder",
    "description": "Skip trace US property addresses: owner or resident name, phones with line type, emails, mailing address and property facts. Pay only when a phone or email is found.",
    "version": "1.1",
    "x-build-id": "HnOihU4Nn20viGUIZ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~skip-trace-property-owner/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-skip-trace-property-owner",
        "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/khadinakbar~skip-trace-property-owner/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-skip-trace-property-owner",
        "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/khadinakbar~skip-trace-property-owner/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-skip-trace-property-owner",
        "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": {
          "addresses": {
            "title": "Property addresses to skip trace",
            "type": "array",
            "description": "List of US property addresses to skip trace, one per entry in the form 'street, city, ST ZIP' (e.g. '123 Main St, Dallas, TX 75201'). Up to 500 per run; duplicates are looked up once. You can also paste a CSV or one-per-line list into addressText instead. Not for searching by owner name or phone.",
            "items": {
              "type": "string"
            }
          },
          "addressObjects": {
            "title": "Address objects (JSON)",
            "type": "array",
            "description": "Optional. A JSON list of address objects, each like {\"street\":\"123 Main St\",\"city\":\"Dallas\",\"state\":\"TX\",\"zip\":\"75201\"} (or {\"address\":\"full address string\"}). Added to the other address fields; duplicates are looked up once."
          },
          "addressText": {
            "title": "Paste addresses or CSV",
            "type": "string",
            "description": "Optional. Paste one address per line ('123 Main St, Dallas, TX 75201') or a CSV with a header row containing street, city, state and zip columns. Added to the addresses list above; duplicates are looked up once."
          },
          "includePhone": {
            "title": "Include phone numbers",
            "type": "boolean",
            "description": "When true (default), return phone numbers with line type and carrier. Set to false to skip phone lookup.",
            "default": true
          },
          "includeEmail": {
            "title": "Include email addresses",
            "type": "boolean",
            "description": "When true (default), return email addresses. Set to false to skip email lookup. If both phone and email are off, no contact data is fetched and no result is billed.",
            "default": true
          },
          "maxResults": {
            "title": "Maximum results to return",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum number of addresses to process from the combined list. Use it to cap a run on large lists. Set to 0 to process every address provided (up to 500). Default 100. Only addresses that return a phone or email are billed.",
            "default": 100
          },
          "concurrency": {
            "title": "Parallel lookups",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many addresses are looked up at the same time. Higher is faster at the same cost: measured 100 addresses in about 5.5 minutes at the default (16) vs 8.7 minutes at 8. Lower it only if you see many 'lookup_failed' rows.",
            "default": 16
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional and usually not needed. The Actor manages its own network access to public directories; this field is accepted only for compatibility and is ignored."
          },
          "debugMode": {
            "title": "Debug mode (save raw HTML)",
            "type": "boolean",
            "description": "Developer option. When on, saves the raw HTML of fetched pages to the key-value store (keys start with DEBUG_). Leave off in normal use.",
            "default": false
          },
          "forceRefresh": {
            "title": "Force fresh lookup",
            "type": "boolean",
            "description": "By default an address looked up in the last 24 hours on your account is served from a private cache (same data, same price, faster). Turn this on to skip the cache and read the public sources again.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}