{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Contact Details Scraper: Emails, Phones, VAT ID",
    "description": "One row per company website: emails by purpose, validated phones, WhatsApp, legal name, VAT/tax id with checksum, address, Google Maps link, coordinates, booking, payments and social profiles. 40+ countries, GDPR-friendly.",
    "version": "0.1",
    "x-build-id": "eS4JCsWPsxbytNW2y"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rastriq~website-contact-extractor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rastriq-website-contact-extractor",
        "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/rastriq~website-contact-extractor/runs": {
      "post": {
        "operationId": "runs-sync-rastriq-website-contact-extractor",
        "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/rastriq~website-contact-extractor/run-sync": {
      "post": {
        "operationId": "run-sync-rastriq-website-contact-extractor",
        "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": {
          "startUrls": {
            "title": "🔗 Websites",
            "type": "array",
            "description": "Company websites or bare domains, one per line, e.g. <code>https://www.example.com</code> or <code>example.co.uk</code>. For each site the Actor reads the home page, its legal pages and the contact page (plus the extra pages you choose below). You can combine this with an input dataset.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "datasetId": {
            "title": "🗺️ Input dataset (optional)",
            "type": "string",
            "description": "Enter the id of a dataset (e.g. a Google Maps scraper run). Every item with a website in <b>Website field</b> is processed and the fields in <b>Fields to keep</b> are copied to <code>inputRef</code> so you can join the results back."
          },
          "datasetField": {
            "title": "Website field",
            "type": "string",
            "description": "Field of the input dataset that holds the website URL. Nested fields with a dot: <code>contact.website</code>.",
            "default": "website"
          },
          "passthroughFields": {
            "title": "Fields to keep",
            "type": "array",
            "description": "Fields of the input dataset copied to <code>inputRef</code> in each result (for joins).",
            "default": [
              "title",
              "placeId"
            ],
            "items": {
              "type": "string"
            }
          },
          "contactMaxPages": {
            "title": "Extra pages per site",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Pages read besides the home page and the legal pages. <b>1</b> = contact page only (default, cheapest in time). Up to <b>5</b> also reads about-us, locations and team pages (more addresses and branches). The price per website does not change.",
            "default": 1
          },
          "includePersonalEmails": {
            "title": "Include personal mailboxes",
            "type": "boolean",
            "description": "Emit mailboxes that name a person (<code>laura.gomez@</code>, <code>j.martin@</code>). Off by default: they are counted in <code>personalEmailsWithheld</code>. Personal data under GDPR — make sure you have a legal basis before enabling it.",
            "default": false
          },
          "includePersonalData": {
            "title": "Include sole-trader identity",
            "type": "boolean",
            "description": "When the business belongs to a natural person (sole trader / autónomo / Einzelunternehmer), emit their name, personal tax id and registered address. Off by default: those fields are empty and listed in <code>personalDataWithheld</code>. Company data is always emitted.",
            "default": false
          },
          "verifyIds": {
            "title": "Verify ids: VIES (EU VAT), Companies House, GLEIF, BrasilAPI",
            "type": "boolean",
            "description": "Check the tax ids found against <b>VIES</b> (EU VAT), <b>GLEIF</b> (LEI) and <b>BrasilAPI</b> (CNPJ); UK company numbers against <b>Companies House</b>. Adds the official name, address, status and whether the name matches the website.",
            "default": false
          },
          "crawlerType": {
            "title": "Fetching mode",
            "enum": [
              "adaptive",
              "http",
              "browser"
            ],
            "type": "string",
            "description": "<b>Adaptive</b>: plain HTTP first, a real browser only for blocked or JavaScript-only sites (recommended). <b>HTTP</b>: cheapest, no browser. <b>Browser</b>: always render.",
            "default": "adaptive"
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Proxy for the website requests. Apify Proxy (automatic) works for most sites.",
            "default": {
              "useApifyProxy": true
            }
          },
          "fallbackProxyConfiguration": {
            "title": "Fallback proxy for blocked sites",
            "type": "object",
            "description": "Optional. Sites that block the main Apify datacenter proxy are first retried from 2 new IPs (free). This proxy (e.g. Residential) is used only if they still block. Leave empty to skip."
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Websites processed in parallel. Lower it if many sites come back blocked.",
            "default": 10
          },
          "respectRobotsTxt": {
            "title": "Respect robots.txt",
            "type": "boolean",
            "description": "Skip legal/contact pages disallowed by the site's robots.txt.",
            "default": true
          },
          "pageTimeoutSeconds": {
            "title": "Page timeout",
            "minimum": 10,
            "maximum": 180,
            "type": "integer",
            "description": "Timeout for each page request, in seconds.",
            "default": 45
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}