{ "openapi": "3.0.1", "info": { "title": "D&B DUNS Lookup & Company Intelligence", "description": "Access the D&B Direct+ API for comprehensive business data. Search companies, lookup DUNS numbers, get firmographics, credit scores, risk ratings, beneficial ownership, and more. Essential for B2B sales intelligence, credit decisions, supplier risk management, and KYC/AML compliance.", "version": "1.3", "x-build-id": "beaDbbrKo2hSh0BWq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~d-b-duns-lookup-company-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-d-b-duns-lookup-company-intelligence", "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/alizarin_refrigerator-owner~d-b-duns-lookup-company-intelligence/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-d-b-duns-lookup-company-intelligence", "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/alizarin_refrigerator-owner~d-b-duns-lookup-company-intelligence/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-d-b-duns-lookup-company-intelligence", "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": [ "task" ], "properties": { "task": { "title": "Task", "enum": [ "search_company", "match_company", "get_company_profile", "get_firmographics", "get_credit_score", "get_risk_rating", "get_financial_stress", "get_payment_info", "get_beneficial_ownership", "get_corporate_linkage", "get_public_records", "get_contacts", "find_competitors", "kyc_compliance", "batch_match" ], "type": "string", "description": "What do you want to do? Start with 'search_company' or 'match_company' to find a DUNS number, then use that DUNS number with the other tasks.", "default": "search_company" }, "username": { "title": "D&B Username", "type": "string", "description": "Your D&B Direct API username. You get this from Dun & Bradstreet when you sign up for a D&B Direct API subscription. If left empty, the actor returns labeled sample data and charges no task events." }, "password": { "title": "D&B Password", "type": "string", "description": "Your D&B Direct API password, from your D&B subscription. If left empty, the actor returns labeled sample data and charges no task events." }, "dunsNumber": { "title": "DUNS Number", "type": "string", "description": "9-digit D-U-N-S number (e.g., 001234567). Required for all tasks except search_company and match_company. Don't know it? Use search_company or match_company first." }, "companyName": { "title": "Company Name", "type": "string", "description": "The business name to search for. Required for search_company and match_company tasks." }, "countryCode": { "title": "Country Code", "type": "string", "description": "ISO 2-letter country code (e.g., US, GB, DE)", "default": "US" }, "state": { "title": "State/Province", "type": "string", "description": "State or province name/code" }, "city": { "title": "City", "type": "string", "description": "City name" }, "postalCode": { "title": "Postal Code", "type": "string", "description": "ZIP or postal code" }, "streetAddress": { "title": "Street Address", "type": "string", "description": "Street address for matching" }, "telephoneNumber": { "title": "Telephone", "type": "string", "description": "Company phone number" }, "registrationNumber": { "title": "Registration Number", "type": "string", "description": "Business registration number (EIN, company number, etc.)" }, "naicsCode": { "title": "NAICS Code", "type": "string", "description": "Industry classification code" }, "sicCode": { "title": "SIC Code", "type": "string", "description": "Standard Industrial Classification code" }, "productCode": { "title": "Product Code", "enum": [ "DCP_STD", "DCP_ENH", "DCP_PREM", "BIR", "COMPR", "CPTR", "BBR" ], "type": "string", "description": "D&B data tier. Only applies to get_company_profile task. STD = basic info, ENH = more detail, PREM = everything. Which ones you can use depends on your D&B subscription.", "default": "DCP_STD" }, "matchType": { "title": "Match Type", "enum": [ "Basic", "Advanced" ], "type": "string", "description": "Matching algorithm type", "default": "Advanced" }, "confidenceLowerLimit": { "title": "Confidence Lower Limit", "minimum": 1, "maximum": 10, "type": "integer", "description": "Minimum confidence score for matches (1-10)", "default": 6 }, "maxCandidates": { "title": "Max Candidates", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of match candidates to return", "default": 10 }, "dunsNumbers": { "title": "DUNS Numbers (Batch)", "type": "string", "description": "Comma-separated list of DUNS numbers for batch operations" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to send results to (Zapier, Make, n8n, etc.)" }, "demoMode": { "title": "Demo Mode (Sample Data Only)", "type": "boolean", "description": "ON = returns labeled sample data for testing (free, no credentials needed). OFF = calls the real D&B API when credentials are provided. If credentials are missing, the actor automatically falls back to the labeled no-charge sample output.", "default": false } } }, "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 } } } } } } } } } }