{ "openapi": "3.0.1", "info": { "title": "Account Intelligence API - Technographics and Contacts", "description": "Profile companies by the technology they use, their IT spend band, buying signals, funding, partners and hiring, and find the people inside them. Search contacts by job title, department, seniority, time in role, company size, revenue, industry and technology. Bring your own key.", "version": "0.1", "x-build-id": "GfmDlvLe5CZngR4JL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~account-intelligence-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-account-intelligence-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/nabeelbaghoor~account-intelligence-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-account-intelligence-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/nabeelbaghoor~account-intelligence-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-account-intelligence-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", "properties": { "mode": { "title": "What this run does", "enum": [ "organizations", "people", "discover" ], "type": "string", "description": "Organizations profiles companies you already have. People fills in contacts you already have from a work email address. Discover searches for people you do not have yet, using person filters and company filters together. The three read different parts of this form, so fields belonging to another mode are ignored rather than causing an error.", "default": "organizations" }, "apiKey": { "title": "API key", "type": "string", "description": "Your own account's API key for this provider, issued by its support team on request. Bring your own key: nothing is shared between runs and the key is never written to the dataset." }, "solutionId": { "title": "Solution identifier", "type": "string", "description": "The UUID of the solution to run these queries under. A subscription has one or more solutions, each holding its own targeting configuration, and most accounts require one. Take it from the provider application. Leave it empty only if your subscription does not use solutions." }, "organizations": { "title": "Companies", "type": "array", "description": "Companies to profile, one per line, as a domain such as example.com or as one of the provider's own organization UUIDs. A full URL works and is reduced to its domain.", "items": { "type": "string" } }, "people": { "title": "People", "type": "array", "description": "People to look up, one per line, as a work email address or as one of the provider's own person UUIDs. Anything that is neither is refused before it is sent, so it costs nothing.", "items": { "type": "string" } }, "jobTitles": { "title": "Job titles", "type": "array", "description": "Job titles to find, one per line, in discover mode. A person matching any of them is returned, and partial titles work, so Manager matches IT Manager and Procurement Manager.", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Departments to find people in, using the provider's own department names. A value outside this list is ignored rather than rejected, which is why these are a dropdown.", "items": { "type": "string", "enum": [ "Sales", "Marketing", "Customer Service", "Information Technology", "Leadership", "Business Operations", "Engineering, Research & Development", "Legal", "Healthcare", "Education", "Finance & Accounting", "Human Resources", "Other" ] }, "default": [] }, "seniorities": { "title": "Seniority", "type": "array", "description": "Seniority bands to match with the person's current employer, using the provider's own vocabulary.", "items": { "type": "string", "enum": [ "C-Suite", "VP", "Director", "Manager", "Other" ] }, "default": [] }, "yearsInCurrentRole": { "title": "Years in current role", "type": "array", "description": "How long the person has held their current role. Under a year is often the strongest buying signal a contact carries, because a new owner tends to re-evaluate what they inherited.", "items": { "type": "string", "enum": [ "<1", "1-3", "3-5", "5-10", "10+" ] }, "default": [] }, "personLocations": { "title": "Person locations", "type": "array", "description": "Where the person is, one per line. Use company locations instead if you care where their employer is based rather than where they are.", "items": { "type": "string" } }, "personKeywords": { "title": "Keywords", "type": "array", "description": "Extra keywords to narrow a people search, one per line.", "items": { "type": "string" } }, "companyDomains": { "title": "Company domains", "type": "array", "description": "Limit a people search to these employers, one domain per line. This is how you work an account list rather than a market.", "items": { "type": "string" } }, "companyIds": { "title": "Company identifiers", "type": "array", "description": "Limit a people search to these companies by the provider's own organization UUIDs, one per line.", "items": { "type": "string" } }, "companyLocations": { "title": "Company locations", "type": "array", "description": "Headquarters locations of the person's current employer, one per line.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Industries of the person's current employer, one per line, for example Technology, Healthcare or Accounting.", "items": { "type": "string" } }, "technologies": { "title": "Technologies the company uses", "type": "array", "description": "Only find people whose employer uses these technologies, one per line, for example AWS, Salesforce or OpenAI. This is the filter that turns a contact list into a displacement or integration play.", "items": { "type": "string" } }, "employeeRanges": { "title": "Company size", "type": "array", "description": "Employee bands of the person's current employer, using the provider's own bands.", "items": { "type": "string", "enum": [ "1-10", "10-50", "50-200", "200-500", "500-1000", "1000-5000", "5000-10000", ">10000", "No data" ] }, "default": [] }, "revenueRanges": { "title": "Company revenue", "type": "array", "description": "Annual revenue bands of the person's current employer, in US dollars, using the provider's own bands.", "items": { "type": "string", "enum": [ "0M-1M", "1M-10M", "10M-50M", "50M-100M", "100M-200M", "200M-1000M", ">1000M", "No data" ] }, "default": [] }, "itSpendRanges": { "title": "Company IT spend", "type": "array", "description": "Estimated annual IT spend bands of the person's current employer, using the provider's own bands. A budget filter rather than a size filter, which is usually the better qualifier for a technology sale.", "items": { "type": "string", "enum": [ "0-50K", "50K-100K", "100K-500K", "500K-1M", "1M-5M", "5M-25M", "25M-100M", "100M-500M", "500M-1000M", "1B-5B", "5B-10B", ">10B", "No data" ] }, "default": [] }, "accountFit": { "title": "Account fit", "type": "array", "description": "Filter to companies matching an account fit band, which only works if account fit is configured in your provider settings. High fit accounts are the ones matching your ideal customer profile.", "items": { "type": "string", "enum": [ "High", "Medium", "Low", "Outside TAM" ] }, "default": [] }, "requireEmail": { "title": "Only people with an email address", "type": "boolean", "description": "Return a person only when an email address is available for them. In people mode this turns a record with no email into a not found answer rather than a row without contact details.", "default": false }, "requirePhone": { "title": "Only people with a phone number", "type": "boolean", "description": "Return a person only when a phone number is available for them.", "default": false }, "validateEmail": { "title": "Validate email addresses", "type": "boolean", "description": "Ask the provider to validate an email address before returning it. Slower, and worth it when the list is going straight into a sending tool.", "default": false }, "onlyNewContacts": { "title": "Only contacts I have not seen before", "type": "boolean", "description": "Leave out people already redeemed through the provider application, your CRM or an earlier API call, so a repeat search returns only what is new. Credits are charged for net new contacts either way.", "default": false }, "resultsPerAccount": { "title": "Maximum people per company", "minimum": 1, "type": "integer", "description": "Cap how many people come back from any one company in discover mode. Without it a single large employer can fill the whole result set." }, "pollIntervalSeconds": { "title": "Seconds between job checks", "minimum": 5, "maximum": 120, "type": "integer", "description": "Discover mode runs as a job at the provider. This is how often the run asks whether it has finished.", "default": 15 }, "maxWaitMinutes": { "title": "Minutes to wait for a search", "minimum": 1, "maximum": 120, "type": "integer", "description": "How long to wait for a discover job before giving up. The job identifier is written to the log either way, and the provider keeps its results for 30 days, so nothing is lost by stopping early.", "default": 20 }, "maxResults": { "title": "Maximum rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many rows. In discover mode this is also sent to the provider as the search ceiling, which the provider caps at 10000 per search.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 900, "type": "integer", "description": "How fast this actor calls the provider. The documented limit is 1000 a minute, and passing it blocks the key for the rest of the window, so this is capped at 900.", "default": 300 } } }, "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 } } } } } } } } } }