{ "openapi": "3.0.1", "info": { "title": "theHarvester OSINT: Hosts, Subdomains & Email", "description": "Find public subdomains, hostnames, IP addresses, and email addresses for one authorized domain using passive theHarvester sources.", "version": "0.1", "x-build-id": "6wHq8ViyEBCSxQ1YC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~theharvester-osint/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-theharvester-osint", "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/khadinakbar~theharvester-osint/runs": { "post": { "operationId": "runs-sync-khadinakbar-theharvester-osint", "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/khadinakbar~theharvester-osint/run-sync": { "post": { "operationId": "run-sync-khadinakbar-theharvester-osint", "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": [ "domain" ], "properties": { "domain": { "title": "Authorized domain", "pattern": "^(?:https?://)?[^\\s?#]+$", "minLength": 3, "maxLength": 253, "type": "string", "description": "Enter one domain you own or are authorized to assess, such as example.com. An http(s) URL is also accepted and reduced to its hostname. IP addresses, wildcards, ports, credentials, and multiple targets are outside this input contract." }, "sources": { "title": "Passive sources", "maxItems": 19, "uniqueItems": true, "type": "array", "description": "Choose subdomains for the curated passive hostname set, emails for the curated email set, all-passive for both plus passive IP-capable providers, or named providers from the allowlist. P1 DNS interaction, direct requests, takeover checks, screenshots, and credential-bearing providers are not exposed.", "items": { "type": "string", "minLength": 1, "maxLength": 40 }, "default": [ "subdomains", "emails" ] }, "maxResults": { "title": "Maximum findings", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum normalized rows written to the default dataset across hostname, email, and IP records. Each persisted row is one finding-returned charge. The default is 50 and the hard input maximum is 250.", "default": 50 }, "perSourceLimit": { "title": "Per-source result limit", "minimum": 1, "maximum": 200, "type": "integer", "description": "Bound the number of results requested from each selected provider. This is a provider-result limit, not the total dataset size. The default is 25 and the maximum is 200.", "default": 25 }, "sourceWorkers": { "title": "Concurrent passive sources", "minimum": 1, "maximum": 8, "type": "integer", "description": "Maximum selected providers queried concurrently. The default of 6 balances collection time and upstream rate limits; lower it when a source set is sensitive to concurrency. This is not a browser or DNS concurrency setting.", "default": 6 }, "includeIps": { "title": "Include IP findings", "type": "boolean", "description": "Return IP addresses when a selected passive source reports them. Defaults to true. Set false when the dataset should contain only hostnames/subdomains and emails; the run summary still records that IP findings were observed.", "default": true }, "startOffset": { "title": "Provider result offset", "minimum": 0, "maximum": 500, "type": "integer", "description": "Starting offset passed to providers that support pagination. Use 0 for the first page. This is an upstream pagination hint and does not guarantee every provider implements offsets identically.", "default": 0 } } }, "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 } } } } } } } } } }