{
  "openapi": "3.0.1",
  "info": {
    "title": "Contact Details & Email Scraper — Phones, Socials, Email Types",
    "description": "E-mails sorted by type (sales, support, management, legal…), phones, WhatsApp, social profiles, company legal name and address from any list of websites, each with its source page. Plain HTTP, fast. Pay only per website with contacts. Lead enrichment for any domain list.",
    "version": "0.1",
    "x-build-id": "54xeRTq9H5YPplGS6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/insanedev~contact-details-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-insanedev-contact-details-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/insanedev~contact-details-scraper/runs": {
      "post": {
        "operationId": "runs-sync-insanedev-contact-details-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/insanedev~contact-details-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-insanedev-contact-details-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": {
          "websites": {
            "title": "Websites",
            "type": "array",
            "description": "Domains or URLs, one per line (example.com, https://www.example.com/page). Each website is read once; duplicates of the same domain are skipped.",
            "items": {
              "type": "string"
            }
          },
          "datasetIds": {
            "title": "Websites from datasets (Google Maps Scraper, Store Leads…)",
            "type": "array",
            "description": "Dataset IDs (or their Console / API links) of earlier runs, e.g. a Google Maps Scraper run: the website of every item is read, places without a website are skipped for free. Works with any dataset whose items have a website, url or domain field.",
            "items": {
              "type": "string"
            }
          },
          "datasetWebsiteField": {
            "title": "Website field in those datasets",
            "type": "string",
            "description": "The item field that holds the website, e.g. website (Google Maps Scraper) or domain (Store Leads). Leave empty to use the first of website, websiteUrl, companyWebsite, domain, companyDomain, homepage, url, site that an item has."
          },
          "maxPagesPerSite": {
            "title": "Max pages per website",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "The homepage plus the contact, imprint, about, team and legal pages it links to (or its sitemap lists). 5 finds e-mails on most sites; more pages = more e-mails on large sites, a bit slower.",
            "default": 5
          },
          "emailTypes": {
            "title": "Only these e-mail types",
            "type": "array",
            "description": "Keep only e-mails of these types (empty = all). Free. Types come from the mailbox name (sales@, datenschutz@), the words before the address and the page it is on; personal = a mailbox that reads like a person's name.",
            "items": {
              "type": "string",
              "enum": [
                "general",
                "support",
                "sales",
                "marketing",
                "management",
                "legal",
                "billing",
                "hr",
                "press",
                "personal",
                "technical",
                "other"
              ],
              "enumTitles": [
                "General (info@, contact@, hello@)",
                "Support / customer service",
                "Sales / orders / bookings",
                "Marketing / ads / partnerships",
                "Management / owner",
                "Legal / privacy",
                "Billing / accounting",
                "HR / jobs",
                "Press / media",
                "Personal (a person's name)",
                "Technical (from DNS: DMARC, hostmaster)",
                "Other"
              ]
            }
          },
          "billableContacts": {
            "title": "Pay only for websites with",
            "type": "array",
            "description": "A website is billed only when at least one contact of these kinds is found (empty = all four). E.g. pick only E-mail: a website with just a Facebook link is free, and comes back without contacts (status noMatchingContacts). WhatsApp counts as a phone and as a messenger.",
            "items": {
              "type": "string",
              "enum": [
                "email",
                "phone",
                "social",
                "messenger"
              ],
              "enumTitles": [
                "E-mail",
                "Phone (incl. WhatsApp)",
                "Social profile (LinkedIn, Facebook, Instagram…)",
                "Messenger (WhatsApp, Telegram, Viber…)"
              ]
            },
            "default": [
              "email",
              "phone",
              "social",
              "messenger"
            ]
          },
          "dnsEmails": {
            "title": "Add technical e-mails from DNS",
            "type": "boolean",
            "description": "Also read the domain's DNS: DMARC report addresses and the SOA hostmaster mailbox, when they are on the domain itself (type technical). Useful when the website publishes no e-mail; these mailboxes are often read by IT, not by sales.",
            "default": false
          },
          "searchFallback": {
            "title": "Search fallback for blocked websites",
            "type": "boolean",
            "description": "When a website shows a bot check, read the search-engine snippets of its own pages (site:example.com contact email) and its social profiles from search. Only results on the website's own domain count.",
            "default": true
          },
          "searchUnreachable": {
            "title": "Search also for websites that are down",
            "type": "boolean",
            "description": "Also use the search fallback for websites that don't answer or show an error page. Mostly dead websites; off by default.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Websites in parallel",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "How many websites are read at the same time. Most of the time goes to waiting for slow websites, so 120 keeps 1 GB of memory busy without running out of CPU.",
            "default": 120
          },
          "useResidentialFallback": {
            "title": "Retry blocked websites through residential proxy",
            "type": "boolean",
            "description": "When a website blocks the datacenter proxy (403, 429, bot check), try once more through Apify residential proxy.",
            "default": true
          },
          "startUrls": {
            "title": "Start URLs (alternative input)",
            "type": "array",
            "description": "Same as Websites, as request objects ({\"url\": \"https://example.com\"}) — handy when you switch from another contact scraper.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "useCache": {
            "title": "Reuse results of the last 7 days",
            "type": "boolean",
            "description": "A website your account already read in the last 7 days, with the same options, is delivered from your own key-value store `contact-details-scraper` instead of being read again (faster; billed like a fresh result). Turn off to force fresh reads.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}