{ "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.0", "x-build-id": "IXQltQcMZecmp7mTd" }, "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. NOT needed for Demo Mode." }, "password": { "title": "D&B Password", "type": "string", "description": "Your D&B Direct API password. Same as above — from your D&B subscription. NOT needed for Demo Mode." }, "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 fake sample data for testing (FREE, no credentials needed). OFF = calls the real D&B API and returns real company data (requires D&B username + password). IMPORTANT: If you want REAL data, you MUST turn this OFF.", "default": true } } }, "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 } } } } } } } } } }