{ "openapi": "3.0.1", "info": { "title": "Company Identity Resolver", "description": "Resolves a company name to its primary domain and LinkedIn URL, one company or a batch of names and domains with one row per entry. Any mix of name, domain, or LinkedIn URL in; one canonical identity out with 0-100 confidence scores, conflict detection, and a match method. Flat, Clay-ready.", "version": "0.0", "x-build-id": "4nIdK3e9wDKayJwpl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~company-identity-resolver/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-company-identity-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~company-identity-resolver/runs": { "post": { "operationId": "runs-sync-mambalabs-company-identity-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~company-identity-resolver/run-sync": { "post": { "operationId": "run-sync-mambalabs-company-identity-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_name": { "title": "Company Name", "type": "string", "description": "Company name, e.g. Stripe. At least one of name, domain, or LinkedIn is required." }, "domain": { "title": "Company Domain", "type": "string", "description": "Bare domain, e.g. stripe.com. The strongest canonical key when provided." }, "linkedin_url": { "title": "LinkedIn URL or Slug", "type": "string", "description": "Full LinkedIn company URL (https://www.linkedin.com/company/stripe) or bare slug (stripe)." }, "company_names": { "title": "Company Names (batch)", "type": "array", "description": "Batch mode. A list of company names, one per line (Stripe, Notion, ...). When this list or domains has at least one entry, batch mode takes precedence over the single fields and every entry produces its own output row with its own confidence_score and match_method. If domains has the same number of entries, name i and domain i are resolved together as one row. A row that fails returns a degraded row and the rest of the batch continues.", "items": { "type": "string" } }, "domains": { "title": "Company Domains (batch)", "type": "array", "description": "Batch mode. A list of bare domains, one per line (stripe.com, notion.so, ...). One output row per entry, or paired with company_names by position when both lists have the same length. Leave empty for single lookups.", "items": { "type": "string" } }, "batchSize": { "title": "Batch Size", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many companies resolve concurrently per wave in batch mode. Default 2, maximum 10. A single input always runs alone. More concurrency meets search engine refusals sooner; raise it for speed only if you accept more unresolved rows.", "default": 2 }, "minLinkedinConfidence": { "title": "Minimum LinkedIn Confidence", "pattern": "^\\s*(100|[1-9]?[0-9])?\\s*$", "type": "string", "description": "A LinkedIn page the actor finds is returned only when its linkedin_confidence 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 linkedin_url is null, with the reason in linkedin_verification. A LinkedIn URL you provide is always returned as given. Sent as a string for Clay compatibility.", "default": "70" }, "skipCache": { "title": "Skip Cache", "enum": [ "false", "true" ], "type": "string", "description": "When \"false\" (default), a successful resolution is cached for 7 days and reused for free on repeat lookups. Set \"true\" to force a fresh resolution. Sent as a string for Clay compatibility.", "default": "false" }, "serperApiKey": { "title": "Serper API key (optional)", "type": "string", "description": "Backup search behind DuckDuckGo for the LinkedIn company page. Used only when the free steps find nothing, at most 2 queries per company (about 0.001 USD each on Serper's paid tier; 2,500 queries free on signup). Falls back to the actor's SERPER_API_KEY environment variable. Leave empty to skip the step." }, "max_charge_usd": { "title": "Maximum charge for this run (USD)", "minimum": 0, "type": "number", "description": "Optional. The run stops before any charge that would take this run's total past this amount in USD, and every row already charged is kept. Leave it empty to rely only on the maximum cost per run set in Apify, which the actor also honors." }, "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 } } } } } } } } } }