{ "openapi": "3.0.1", "info": { "title": "LinkedIn Mass Company Profile Finder By Country & Name", "description": "LinkedIn Mass Company Profile Finder by Country & Name discovers public LinkedIn company profiles using company names and country filters. Extract company URLs, industries, employee sizes, headquarters, websites, follower counts, and more for B2B lead generation, sales, and market research.", "version": "0.1", "x-build-id": "ew4EyeJmx9QK1iNbI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~linkedin-mass-company-profile-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-linkedin-mass-company-profile-finder", "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/simpleapi~linkedin-mass-company-profile-finder/runs": { "post": { "operationId": "runs-sync-simpleapi-linkedin-mass-company-profile-finder", "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/simpleapi~linkedin-mass-company-profile-finder/run-sync": { "post": { "operationId": "run-sync-simpleapi-linkedin-mass-company-profile-finder", "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": { "companyKeywords": { "title": "๐Ÿ” Company Keywords / Names / Domains", "type": "array", "description": "Any list of search keywords โ€” domains (`alma.fr`), exact company names (`\"Acme Corp\"`), brand + qualifier (`\"Stripe\" payments`), or plain text. Each line is searched independently. Accepts the same values as the base actor's `urls` field (see `urls` below for backward compatibility).", "items": { "type": "string" } }, "urls": { "title": "๐Ÿ”— Keywords (Legacy Alias)", "type": "array", "description": "Legacy alias for `companyKeywords`, kept for backward compatibility with the original LinkedIn Mass Company Profile Finder's input shape. If both are provided, `companyKeywords` takes priority. New runs should use `companyKeywords` above.", "items": { "type": "string" } }, "maxResultsPerKeyword": { "title": "๐Ÿ“Š Max Results Per Keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "Upper bound on how many search results are examined per keyword per engine before moving on. Higher = more thorough, slower, more requests. Default is 30.", "default": 30 }, "workers": { "title": "๐Ÿงต Concurrent Workers", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many keywords are processed in parallel. Higher = faster runs but more simultaneous requests. Default is 3.", "default": 3 }, "maxRetries": { "title": "๐Ÿ” Max Retries Per Engine", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times a single search engine is retried on a temporary failure before the actor escalates to the next proxy tier. Default is 2.", "default": 2 }, "targetCountries": { "title": "๐ŸŒ Target Country Subdomains", "type": "array", "description": "2-3 letter LinkedIn country-subdomain codes, e.g. `fr` (France), `uk` (United Kingdom), `de` (Germany), `in` (India), `au` (Australia). Works together with 'Country Filter Mode' below. Leave empty to disable country filtering entirely (all subdomains, including the bare www. form, pass through).", "items": { "type": "string" } }, "targetCountriesMode": { "title": "๐ŸŽฏ Country Filter Mode", "enum": [ "include", "exclude" ], "type": "string", "description": "How 'Target Country Subdomains' above is applied. 'Only include these countries' keeps ONLY results whose matched country subdomain is in the list (the bare www. form is dropped unless listed). 'Exclude these countries' keeps everything EXCEPT results matched on a listed country subdomain. Ignored when the list above is empty.", "default": "include" }, "enableSuffixExpansion": { "title": "๐Ÿท๏ธ Enable Legal-Entity Suffix Expansion", "type": "boolean", "description": "When ON (default), keywords that return fewer matches than the threshold below are automatically retried with legal-entity suffixes appended. Each recovered row is tagged with the exact suffix that produced it via the `matchedVariant` output field (null when the direct keyword itself matched).", "default": true }, "suffixExpansionThreshold": { "title": "๐Ÿ“‰ Expansion Trigger Threshold", "minimum": 0, "maximum": 50, "type": "integer", "description": "If a keyword's direct search returns FEWER matches than this number, suffix expansion kicks in (when enabled above) to try to reach it. Set to 0 to effectively disable expansion regardless of the toggle above. Default is 2.", "default": 2 }, "maxSuffixVariantsPerKeyword": { "title": "๐Ÿงข Max Suffix Variants Per Keyword", "minimum": 0, "maximum": 10, "type": "integer", "description": "Hard cap on how many legal-entity suffix variants are tried per keyword, even if the threshold is never reached โ€” bounds the extra search calls this feature can generate. Default is 4.", "default": 4 }, "customLegalSuffixes": { "title": "๐Ÿ“ Legal-Entity Suffix List", "type": "array", "description": "The suffixes tried one at a time (in order) when expansion triggers, e.g. \"Acme\" + \"Inc\" โ†’ \"Acme Inc\". Customize to add local variants (e.g. \"S.A.\", \"B.V.\", \"SARL\", \"Pte Ltd\"). Leave as the default list if unsure.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy Configuration", "type": "object", "description": "Default: no proxy (saves cost). If search engines block the request, the actor automatically escalates: no-proxy โ†’ Datacenter โ†’ Residential (3 retries). After a successful fallback, the chosen proxy is reused for all remaining keywords. You can also pre-configure Apify proxy here if you want to start with one." } } }, "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 } } } } } } } } } }