{ "openapi": "3.0.1", "info": { "title": "Business Profile Scraper – Contacts & Socials", "description": "Scrape a full business profile from a name or website: Google rating, reviews, category and address, every email and phone from the company site, plus social accounts with follower counts and latest posts.", "version": "0.1", "x-build-id": "L5Jz9xEOBmw7BKUDL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simple.actors~business-profile/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simple.actors-business-profile", "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/simple.actors~business-profile/runs": { "post": { "operationId": "runs-sync-simple.actors-business-profile", "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/simple.actors~business-profile/run-sync": { "post": { "operationId": "run-sync-simple.actors-business-profile", "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": { "queries": { "title": "Businesses to look up (name + place)", "type": "array", "description": "One business per line, written as a name and a place: \"Dishoom Covent Garden London\", \"Bungalow restaurant east village new york\". The more specific the place, the more reliably Google returns a knowledge panel (rating, reviews, address, phone) rather than a list of similar businesses — a bare name in a big city often matches the wrong branch. Each row comes back tagged with the query you typed, so you can match results to your list.", "items": { "type": "string" } }, "websites": { "title": "Websites you already have (skips the Google search)", "type": "array", "description": "Use this instead when you already know a business's website — one domain or URL per line, e.g. \"dishoom.com\". The Google lookup is skipped entirely, since there is nothing to search for, so you get the website contacts and social accounts but no rating, review count or place address.", "items": { "type": "string" } }, "startUrls": { "title": "Websites you already have (URL list)", "type": "array", "description": "Exactly the same as \"Websites you already have\", in the URL-list editor — useful when your URLs come from a file, another Actor or a Google Sheet rather than being typed in.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeContacts": { "title": "Read the website for contact details", "type": "boolean", "description": "On by default. Crawls the business's own site for every email address, every valid phone number, a postal address, a contact form and its social account links. Those links are what the social step then enriches, so turning this off leaves only the Google place record.", "default": true }, "includeSocialProfiles": { "title": "Read each social account for followers and posts", "type": "boolean", "description": "On by default. For each social account found on the website, opens that account and reads its live follower count, display name, verification and three latest posts. Instagram, TikTok, X (Twitter), YouTube, Facebook and LinkedIn are read in full; every other platform (Yelp, Pinterest…) keeps its link and handle, which is still the useful half. LinkedIn company pages are read; personal LinkedIn profiles cannot be, because LinkedIn serves those only behind a login.\n\nThis is the slow and expensive part: each platform is a separate run, so a business with four accounts takes about a minute. Turn it off for a fast place-plus-contacts sweep.", "default": true }, "maxSocialProfiles": { "title": "Maximum social accounts to read per business", "minimum": 0, "maximum": 6, "type": "integer", "description": "A ceiling on the slow part, per business — 3 by default, up to 6. Accounts on platforms that can actually be read (Instagram, TikTok, X, YouTube, Facebook, LinkedIn) are tried first, so a low number is spent well. Accounts beyond the limit are still returned as links with their handles. Set to 0 to collect links only.", "default": 3 } } }, "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 } } }, "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 } } } } } } } } } }