{ "openapi": "3.0.1", "info": { "title": "Company Name to Domain Finder — Logo, LinkedIn & Socials", "description": "Turn company names into domains with a match confidence score, then enrich each company from its own website: logo, LinkedIn company page, X, Facebook, Instagram, YouTube and TikTok links, role mailboxes (info@, sales@) and Wikidata facts. Misses are free.", "version": "0.1", "x-build-id": "NPdXfI9cYr9Aq4A1Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~company-domain-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-company-domain-enrichment", "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/yugenox~company-domain-enrichment/runs": { "post": { "operationId": "runs-sync-yugenox-company-domain-enrichment", "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/yugenox~company-domain-enrichment/run-sync": { "post": { "operationId": "run-sync-yugenox-company-domain-enrichment", "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": { "companies": { "title": "🏢 Companies", "type": "array", "description": "One company per line: a company name (\"Shopify\"), a domain or website (\"stripe.com\", \"https://www.hubspot.com\"), or both (\"HubSpot, hubspot.com\"). Names are resolved to their domain; domains are enriched from the company's own website. Duplicates are looked up once.", "items": { "type": "string" } }, "enrich": { "title": "🌐 Enrich from the company website", "type": "boolean", "description": "Read the company's homepage (plus one about or contact page when needed) for the logo, social links, the LinkedIn company page linked from the site, phone numbers and role mailboxes. Off = name to domain only.", "default": true }, "roleEmails": { "title": "✉️ Role mailboxes", "type": "boolean", "description": "Collect role mailboxes on the company's own domain: info@, sales@, support@, hello@, press@ and similar. Addresses of named people are never collected.", "default": true }, "companyFacts": { "title": "📚 Company facts from Wikidata", "type": "boolean", "description": "Add the Wikidata id, headquarters country and city, founding year and industry when the company is on Wikidata, and fill social links the website does not show. No extra charge.", "default": true }, "minConfidence": { "title": "🎯 Minimum match confidence", "minimum": 0, "maximum": 1, "type": "number", "description": "Names whose best match scores below this (0 to 1) count as not found and are free. 0.6 suits most lists; use 0.8 for CRM imports where a wrong domain is worse than none. Rows show the score in matchConfidence and close alternatives in otherCandidates.", "default": 0.6 }, "countryHint": { "title": "📍 Country hint", "type": "string", "description": "Optional country for every name, e.g. \"Canada\" or \"US\". It favours the company headquartered there when several share a name. Records can carry their own country column instead." }, "maxPagesPerSite": { "title": "📄 Pages per website", "minimum": 1, "maximum": 3, "type": "integer", "description": "1 = homepage only. 2 (default) = homepage plus one about or contact page when the homepage has no role mailbox or social link. 3 = up to two extra pages.", "default": 2 }, "includeMisses": { "title": "Include misses in the dataset", "type": "boolean", "description": "Also save a row (free) for every company that was not found, scored below the minimum confidence, or whose website gave nothing, with the reason in status. Off = misses are listed only in the run report.", "default": false }, "maxCompanies": { "title": "Max companies", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Look up at most this many companies from the list. Empty = all (up to 50,000 per run)." }, "items": { "title": "Company records", "type": "array", "description": "Objects with any of these columns: companyName / company / name / title, domain / website / url, country (a location / city column is used only when it ends in a country name). Example: [{\"companyName\": \"Shopify\", \"country\": \"Canada\"}]." }, "csvUrl": { "title": "CSV link", "type": "string", "description": "A link to a CSV file with a company name and / or website column (Google Sheets links work when the sheet is shared with \"Anyone with the link\"). A one-column file without a header works too." }, "datasetId": { "title": "Apify dataset", "type": "string", "description": "The id of an Apify dataset whose items have a company name and / or website (for example the output of Google Maps Scraper: title + website)." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxies are all this Actor needs. Residential proxies are not used: websites that block datacenter traffic are reported as blocked and not charged for enrichment.", "default": { "useApifyProxy": 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 } } } } } } } } } }