{ "openapi": "3.0.1", "info": { "title": "Data Legion Person and Company Enrichment", "description": "Enrich people by email, phone or LinkedIn URL and companies by domain or name with Data Legion. Pay only for matched records.", "version": "0.1", "x-build-id": "IhiwEVdxzSHQsYmrf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalegion~data-legion-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalegion-data-legion-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/datalegion~data-legion-enrichment/runs": { "post": { "operationId": "runs-sync-datalegion-data-legion-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/datalegion~data-legion-enrichment/run-sync": { "post": { "operationId": "run-sync-datalegion-data-legion-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", "required": [ "product" ], "properties": { "product": { "title": "Product", "enum": [ "person_base_no_pii", "person_base_pii", "person_premium_no_pii", "person_premium_pii", "company_base", "company_premium" ], "type": "string", "description": "Which data you get back for each match. Person Base: name, headline, summary, current job and company, work history, education, skills, languages and social profiles. Person Premium adds seniority, job function, expense category, decision-maker and platform-worker flags, years of experience, tenure, highest degree, certifications, LinkedIn follower and connection counts, and data freshness. \"With contact data\" adds emails, phones, location, age and sex. Company Base: name, headline, description, domains, industry, size, type, founding year, office locations, tickers and social profiles; Company Premium adds office coordinates, headcount, hiring, attrition, growth, turnover, tenure, workforce breakdowns, LinkedIn follower and employee counts, and data freshness. Each matched record is charged once at the product's price; no-matches are free. Products with contact data and the Premium products need a paid Apify plan; free plans get up to 25 matched records per run.", "default": "person_base_no_pii" }, "emails": { "title": "Emails", "type": "array", "description": "Person products only. One email per line.", "items": { "type": "string" } }, "phones": { "title": "Phone numbers", "type": "array", "description": "Person products only. Include the country code, e.g. +1 415 555 0100.", "items": { "type": "string" } }, "socialUrls": { "title": "Social profile URLs", "type": "array", "description": "Person products only. LinkedIn, GitHub, X and similar profile URLs.", "items": { "type": "string" } }, "domains": { "title": "Company domains", "type": "array", "description": "Company products only, e.g. apify.com.", "items": { "type": "string" } }, "companyNames": { "title": "Company names", "type": "array", "description": "Company products only. A domain matches more reliably than a name.", "items": { "type": "string" } }, "records": { "title": "Records (advanced)", "type": "array", "description": "Objects with any Data Legion enrich fields, for lookups the lists above don't cover. People: email, email_hash, phone, social_url, linkedin_id, legion_id, or a name (full_name, or first_name + last_name) with one of company, school, job_title, city, state, country, postal_code, address, birth_date. Companies: domain, name, linkedin_id, social_url, ticker_symbol, legion_id, optionally industry." }, "minConfidence": { "title": "Minimum match confidence", "enum": [ "high", "moderate", "low" ], "type": "string", "description": "Drop matches below this confidence. Leave empty for the API default." }, "requiredFields": { "title": "Required fields", "type": "string", "description": "Fields a match must have, combined with AND, OR and parentheses, e.g. work_email OR mobile_phone. Matches without them count as no-match and aren't charged." } } }, "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 } } } } } } } } } }