{ "openapi": "3.0.1", "info": { "title": "Stibnite B2B Lead Enrichment API", "description": "Find and enrich B2B people and companies with business emails, titles, LinkedIn URLs, and firmographics. Use batch runs or the Standby API for lead generation, CRM enrichment, and outbound workflows.", "version": "0.1", "x-build-id": "Ga4BQrHrYgAqVMPV7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/people-data~stibnite-person-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-people-data-stibnite-person-data-api", "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/people-data~stibnite-person-data-api/runs": { "post": { "operationId": "runs-sync-people-data-stibnite-person-data-api", "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/people-data~stibnite-person-data-api/run-sync": { "post": { "operationId": "run-sync-people-data-stibnite-person-data-api", "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": [ "mode" ], "properties": { "mode": { "title": "Operation", "enum": [ "person_search", "person_lookup", "company_search", "company_people" ], "type": "string", "description": "Choose the Stibnite API operation to run. Person search is the default for lead generation.", "default": "person_search" }, "query": { "title": "Search query", "type": "string", "description": "For Person search or Company search. Describe the people or companies you want to find." }, "maxRecords": { "title": "Maximum enriched records", "minimum": 1, "type": "integer", "description": "Maximum successfully delivered records to charge for and return in this run.", "default": 100 }, "lookup": { "title": "Exact person lookup", "type": "object", "description": "Use only for Person lookup. Provide at least one identifier.", "properties": { "email": { "title": "Email", "type": "string", "description": "Business email address to look up.", "editor": "textfield" }, "linkedinUrl": { "title": "LinkedIn URL", "type": "string", "description": "LinkedIn profile URL to look up.", "editor": "textfield" }, "companyDomain": { "title": "Company domain", "type": "string", "description": "Company domain to use with another person identifier.", "editor": "textfield" }, "phone": { "title": "Phone", "type": "string", "description": "Phone number to look up when available.", "editor": "textfield" } }, "additionalProperties": false }, "companyDomain": { "title": "Company domain", "type": "string", "description": "Required only for Company people mode, for example example.com." }, "locationCity": { "title": "Location city", "type": "string", "description": "Optional company city filter for Person search." }, "locationState": { "title": "Location state", "type": "string", "description": "Optional company state filter for Person search, such as ID or Idaho." }, "limit": { "title": "Page size", "minimum": 1, "maximum": 500, "type": "integer", "description": "Records requested per upstream page. Person and company search are capped by the Stibnite API at 100; company_people is capped at 500.", "default": 100 }, "maxPages": { "title": "Maximum upstream pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Safety cap on upstream pagination for batch runs.", "default": 1 }, "campaignDedupeId": { "title": "Campaign dedupe ID", "type": "string", "description": "Optional campaign or workflow ID to avoid repeat person delivery for the same interpreted search." }, "retryId": { "title": "Retry ID", "type": "string", "description": "Optional retry ID. Reusing the same ID with the same request returns the cached summary without charging again." } } }, "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 } } } } } } } } } }