{
  "openapi": "3.0.1",
  "info": {
    "title": "Contact Details Scraper & Website Email Finder",
    "description": "Contact details scraper and website email finder: paste websites or domains, get one business email per site with the page that proves it, plus phone, contact page and social links. $2 per 1,000 websites with an email found; no email, no charge.",
    "version": "1.0",
    "x-build-id": "UPpEB0zle01WExP2L"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aurelmark~website-contact-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aurelmark-website-contact-finder",
        "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/aurelmark~website-contact-finder/runs": {
      "post": {
        "operationId": "runs-sync-aurelmark-website-contact-finder",
        "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/aurelmark~website-contact-finder/run-sync": {
      "post": {
        "operationId": "run-sync-aurelmark-website-contact-finder",
        "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": {
          "websites": {
            "title": "Websites",
            "type": "array",
            "description": "Company websites or bare domains, one per line, for example example.com or https://www.example.com. Up to 10,000 in one run. Through the API each item may also be a row such as {\"website\": \"example.com\", \"id\": \"A-17\", \"country\": \"GB\"}: your other columns come back unchanged under input. The name startUrls is accepted for this field too. One output row per website; a website that appears twice is read once.",
            "items": {
              "type": "string"
            }
          },
          "includeNamedPeople": {
            "title": "Include emails of named people (off: info@, sales@ and other company addresses only)",
            "type": "boolean",
            "description": "Off by default: only role addresses such as info@ or sales@ and other general business addresses are returned, and each row says how many addresses of named people were left out. Turn on to also return addresses that belong to a named person, such as jane.doe@, or that may be one person's mailbox, such as a role word beside a name. You are then handling personal data and need your own lawful reason to use it.",
            "default": false
          },
          "includePhones": {
            "title": "Include phone numbers",
            "type": "boolean",
            "description": "Return the company's phone numbers in international format. Numbers from phone links come first; numbers that cannot be confirmed as valid are listed apart and never chosen as the best phone. Turn off if you only need emails. The price is the same either way.",
            "default": true
          },
          "defaultCountry": {
            "title": "Default country for phones",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "A two-letter country code such as GB, DE, IN or US. It is used to read phone numbers written without a country code when a row gives no country of its own. Leave empty to let the tool take the country from the domain ending or the page language. It has no effect on emails."
          },
          "includeSocial": {
            "title": "Include social pages",
            "type": "boolean",
            "description": "Return links to the company's own LinkedIn, Facebook, Instagram, X, YouTube and TikTok pages when its website links to them. The tool only copies the links from the company's website; it never visits or reads the social networks.",
            "default": true
          },
          "legalNotice": {
            "title": "Read the legal notice (DE, AT, CH)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return the company's legal form, register court, register number and VAT ID, read from its legal notice (Impressum) page when that page is read anyway. No extra page, no extra charge. Left empty when the notice does not state them, for sole traders, and when the legal form is unknown. Never a person's name.",
            "default": false
          },
          "skipSeen": {
            "title": "Skip websites delivered before",
            "type": "boolean",
            "description": "Turn on to not read and not charge a website that an earlier run with this option already delivered. Such rows come back with status skipped_seen. The memory is a list of domains and dates kept in a key-value store named website-contact-finder-seen in your own account; nothing else is stored.",
            "default": false
          },
          "recheckAfterDays": {
            "title": "Read again after this many days",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only with skipSeen on. A website delivered this many days ago or longer is read again, and charged again if an email is found. Leave empty to never read a delivered website again. Example: 90 reads each website at most once every 90 days."
          },
          "maxPagesPerSite": {
            "title": "Pages per website",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "The most pages read on one website, from 1 to 10. The tool reads the home page first, then the contact, legal notice and about pages it links to, and stops early once an email is found. More pages can find a few more emails and make a run slower. The price does not depend on this number.",
            "default": 5
          },
          "extraSources": {
            "title": "Also check the site's security contact file (security.txt)",
            "type": "boolean",
            "description": "Only when the site's pages give no address on its own domain: also read its security.txt. An address from it is a desk for security reports, so it is ranked last and given low confidence.",
            "default": true
          },
          "resetSeen": {
            "title": "Forget delivered websites",
            "type": "boolean",
            "description": "Turn on for one run to empty the memory used by skipSeen before the run starts, so every website is read again. Websites of this run are remembered again if skipSeen is also on. Turn it off afterwards.",
            "default": false
          },
          "maxComputeUsd": {
            "title": "Stop when compute reaches (USD)",
            "minimum": 0.001,
            "maximum": 100,
            "type": "number",
            "description": "Optional. The run stops cleanly, keeping the rows it has, once its own compute passes this many US dollars; websites not read yet get a free not_checked row. Leave empty for the default: $0.05 per 1,000 websites x 3, at least $0.02, more with more memory (see Limits)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}