{ "openapi": "3.0.1", "info": { "title": "Website Contact Scraper: Emails, Phones, Socials + AI", "description": "Emails, phones, social profiles, contact page and legal notice of any company website, one row per website, with optional AI company summary. Pay per website.", "version": "0.1", "x-build-id": "Aj2oOSlF6LPBr34jz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetchwise~website-contact-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetchwise-website-contact-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/fetchwise~website-contact-scraper/runs": { "post": { "operationId": "runs-sync-fetchwise-website-contact-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/fetchwise~website-contact-scraper/run-sync": { "post": { "operationId": "run-sync-fetchwise-website-contact-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", "required": [ "websites" ], "properties": { "websites": { "title": "Websites", "type": "array", "description": "One website per line: a domain (acme.com) or any URL on it (https://www.acme.com/en/). The Actor starts at the home page of that host and reads it plus its contact, legal notice, about and team pages. The same website twice is read and charged once. Social profiles, marketplaces and link-in-bio pages (facebook.com/…, linktr.ee/…) are not company websites and get a free row with the reason.", "items": { "type": "string" } }, "maxPagesPerWebsite": { "title": "Pages per website", "minimum": 1, "maximum": 10, "type": "integer", "description": "Pages read per website, home page included (1-10). After the home page the Actor reads, in this order, the pages linked as contact, legal notice (Impressum, imprint, mentions légales), about and team, in 12 languages. The price per website is the same whatever the number.", "default": 5 }, "includePersonalContacts": { "title": "Include personal contacts", "type": "boolean", "description": "Also return emails that look like a person's (jane.doe@acme.com) and personal LinkedIn profiles (linkedin.com/in/…) found on the site. Turn off to keep only role addresses (info@, sales@) and company profiles, which holds less personal data under GDPR.", "default": true }, "defaultPhoneRegion": { "title": "Default phone country", "pattern": "^([A-Za-z]{2})?$", "type": "string", "description": "Two-letter country code used to read phone numbers written without a country code, e.g. US, GB, DE. Empty: the country of the site's structured address, else its country domain (.de → DE, .co.uk → GB), else the page language (vi → VN, en-GB → GB), else US. Numbers that are not valid in that country are left out." }, "aiEnrichment": { "title": "AI enrichment", "type": "boolean", "description": "Add AI fields read from the same pages: legal company name, a two-sentence summary, industry, business model (B2B/B2C), main offerings, country, city and postal address. Only for websites with at least one contact. Charged per enriched website as a separate event; a website the AI step could not enrich is not charged for it.", "default": false }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip pages the site's robots.txt disallows for crawlers. A website whose home page is disallowed gets a free row with the reason.", "default": true }, "maxConcurrency": { "title": "Websites at the same time", "minimum": 1, "maximum": 50, "type": "integer", "description": "Websites read at the same time (1-50). Pages of one website are read one after another.", "default": 10 }, "requestTimeoutSecs": { "title": "Timeout per page (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "Time limit per page (5-60 seconds). A website whose home page does not answer gets a free row with the reason.", "default": 20 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for most websites: the Actor connects directly, which in tests reached more sites than Apify datacenter proxy. Apify datacenter proxy or your own proxies can be used for sites that block the run's IP. Residential proxy is not supported.", "default": { "useApifyProxy": 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 } } } } } } } } } }