{ "openapi": "3.0.1", "info": { "title": "Certificate Transparency & DNS Subdomain Inventory", "description": "Discover subdomains from public certificate tables, validate DNS and optionally profile public pages. Includes source coverage and reports without external provider APIs.", "version": "0.2", "x-build-id": "5Y7DVwZdo8odBIea3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrapelab~subdomain-intelligence-osint/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrapelab-subdomain-intelligence-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/thescrapelab~subdomain-intelligence-osint/runs": { "post": { "operationId": "runs-sync-thescrapelab-subdomain-intelligence-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/thescrapelab~subdomain-intelligence-osint/run-sync": { "post": { "operationId": "run-sync-thescrapelab-subdomain-intelligence-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": [ "authorizedUseOnly", "domains" ], "properties": { "authorizedUseOnly": { "title": "I confirm I am authorized to assess these domains", "type": "boolean", "description": "Required. The Actor refuses to run unless this is true. Only scan domains you own or are explicitly authorized to assess.", "default": true }, "domains": { "title": "Root domains", "minItems": 1, "type": "array", "description": "Authorized root domains such as iana.org or company.co.uk.", "items": { "type": "string" }, "default": [ "iana.org" ] }, "searchLevel": { "title": "Search level", "enum": [ "quick", "deep", "extraDeep" ], "type": "string", "description": "Choose how broad the run should be. Quick is fastest and is used as the default for automated Store health checks. Deep is recommended for normal use. Extra deep uses the broadest safe source selection and bounded candidate generation.", "default": "quick" }, "monitoringOptions": { "title": "Repeat-run monitoring (optional)", "type": "object", "description": "Leave omitted for ordinary inventory. For persistent comparisons, supply {\"monitoringMode\":\"updateBaseline\",\"baselineStoreName\":\"my-asset-watchlist\"}. Reuse the same unique name; one active run per watchlist. compareWithPrevious reads without updating. Missing observations are not removal proof." }, "websiteUrls": { "title": "Specific websites to check (optional)", "maxItems": 1000, "type": "array", "description": "HTTP(S) websites or hostnames within your authorized root domains. Checks only these homepages in profile-only mode; no subdomain discovery. Include apex domains explicitly when needed. Paths and query strings are ignored. Leave empty for ordinary subdomain discovery.", "items": { "type": "string" } }, "technologyQuery": { "title": "Technology question (optional)", "maxLength": 500, "type": "string", "description": "Examples: PHP below 8.0 on .co.nz; Which WordPress version do these sites expose?; nginx >=1.24. One technology, one optional version comparison and one optional suffix. Searches the supplied scope only; no search-engine or country-wide discovery. Unknowns are retained." }, "technologyFilter": { "title": "Structured technology filter (optional)", "type": "object", "description": "Alternative to the question. Example: {\"technology\":\"PHP\",\"version\":\"<8.0\",\"domainSuffix\":\"co.nz\"}. Bare versions such as 7.4 match a version family. Use one question or one structured filter." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }