{ "openapi": "3.0.1", "info": { "title": "Domain to LinkedIn URL Resolver", "description": "Resolves a company domain, or a batch list of domains in one run, to its LinkedIn company URL, one row per domain. A URL is returned only when verified against the company's own site, the input name, or the domain; otherwise the row says why. Flat, Clay-ready, MCP-ready.", "version": "0.3", "x-build-id": "hkEPEUSoD5YgvU4vf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~domain-to-linkedin-url-resolver/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-domain-to-linkedin-url-resolver", "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/mambalabs~domain-to-linkedin-url-resolver/runs": { "post": { "operationId": "runs-sync-mambalabs-domain-to-linkedin-url-resolver", "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/mambalabs~domain-to-linkedin-url-resolver/run-sync": { "post": { "operationId": "run-sync-mambalabs-domain-to-linkedin-url-resolver", "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": { "company_domain": { "title": "Company Domain", "type": "string", "description": "Company domain (bare, e.g. stripe.com). Required if company_name is not provided. When provided, enables pattern match resolution before web search fallback." }, "company_name": { "title": "Company Name", "type": "string", "description": "Company name. Required if company_domain is not provided. When provided alongside a domain, improves web search accuracy." }, "domains": { "title": "Company Domains (batch)", "type": "array", "description": "Batch mode. A list of bare domains, one per line (stripe.com, notion.so, ...). When this list has at least one entry it takes precedence over company_domain and company_name, and every entry produces its own output row with its own resolution_method and confidence. A row that fails returns an error row and the rest of the batch continues. Leave empty for single lookups.", "items": { "type": "string" } }, "batchSize": { "title": "Batch Size", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many domains resolve concurrently per wave in batch mode. Default 2, maximum 10. Only read when domains is supplied. Higher values run more search requests at once through the proxy, and those time out more often, so raise it for speed only if you accept more degraded not_found rows.", "default": 2 }, "minConfidenceScore": { "title": "Minimum Confidence Score", "pattern": "^\\s*(100|[1-9]?[0-9])?\\s*$", "type": "string", "description": "A LinkedIn page is returned only when its match score is at least this value, 0 to 100. Default \"70\". The score comes from evidence that the page belongs to this company: the company homepage links it (92 to 95), its name is identical to the name the company site declares (85) or to the company name you provide (80), or its slug and name both match the domain (75). Under the floor the row returns no URL, with the reason in verification. Raise it for fewer, surer answers; lower it for more answers and more wrong ones. Sent as a string for Clay compatibility.", "default": "70" }, "includeFirmographics": { "title": "Include Firmographics", "enum": [ "false", "true" ], "type": "string", "description": "When \"true\", also reads firmographics from the search result snippets about the LinkedIn company page: follower_count and company_description for most established companies, and employee_count_approx, industry and hq_location when a snippet states them. No request is sent to LinkedIn. Off by default because it can add a search. Leave \"false\" to return just the resolved LinkedIn URL, slug, method, confidence, and social links; the firmographic fields are still present but null. Sent as a string for Clay compatibility (accepts \"true\"/\"false\").", "default": "false" }, "skipCache": { "title": "Skip Cache", "enum": [ "false", "true" ], "type": "string", "description": "When \"false\" (default), a successful resolution is cached for 7 days and reused on repeat lookups, skipping the search work. Set \"true\" to force a fresh resolution and ignore any cached result. Sent as a string for Clay compatibility.", "default": "false" }, "max_charge_usd": { "title": "Maximum charge for this run (USD)", "minimum": 0, "type": "number", "description": "Optional. The run stops before the next result that would take this run's charges over this amount, and keeps every result already charged. Leave empty to rely only on the maximum cost per run you set in Apify." }, "source_tag": { "title": "Source Tag", "type": "string", "description": "Internal attribution tag set by Mamba Labs on published task examples. Not required, and nothing depends on it. Leave it empty." } } }, "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 } } } } } } } } } }