{ "openapi": "3.0.1", "info": { "title": "Certificate Transparency & Subdomain Discovery Scraper", "description": "Discover subdomains and SSL/TLS certificates for any domain from public certificate transparency logs. Extract SAN hostnames, issuer, validity dates, wildcard and expiry flags. Perfect for attack-surface mapping, OSINT and asset inventory. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "hzvdXdKJFdDGotPvr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~certificate-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-certificate-transparency-scraper", "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/scrapers_lat~certificate-transparency-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-certificate-transparency-scraper", "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/scrapers_lat~certificate-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-certificate-transparency-scraper", "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": { "domain": { "title": "Domain(s)", "type": "string", "description": "One or more domains to search, for example example.com. Separate multiple domains with commas, spaces or new lines. Enter the registered domain only (no http, no path)." }, "outputMode": { "title": "Output Mode", "enum": [ "Certificates", "Unique subdomains" ], "type": "string", "description": "Certificates returns one row per certificate found in the transparency logs. Unique subdomains aggregates all certificates into one row per discovered hostname (with first seen, last seen and certificate count).", "default": "Certificates" }, "includeSubdomains": { "title": "Include Subdomains", "type": "boolean", "description": "When on (recommended), discover every subdomain of the domain. When off, only certificates that exactly match the domain itself are returned.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of records to collect across all domains. Free Apify accounts are capped at 10 per run." }, "excludeExpired": { "title": "Exclude Expired", "type": "boolean", "description": "Skip certificates whose validity period has already ended.", "default": false }, "currentlyValidOnly": { "title": "Currently Valid Only", "type": "boolean", "description": "Only return certificates that are valid right now (not expired and not yet-to-start).", "default": false }, "wildcardOnly": { "title": "Wildcard Only", "type": "boolean", "description": "Only return wildcard certificates (those covering *.domain).", "default": false }, "issuer": { "title": "Issuer Contains", "type": "string", "description": "Only return certificates whose issuer contains this text, for example Let's Encrypt, DigiCert, Sectigo, Google." }, "matchHostname": { "title": "Hostname Contains", "type": "string", "description": "Only return certificates that include a hostname containing this text, for example api, vpn, staging, mail." }, "sinceDate": { "title": "Issued Since", "type": "string", "description": "Only return certificates that became valid on or after this date (YYYY-MM-DD). Useful for monitoring newly issued certificates." }, "withLiveResolve": { "title": "Live resolve (DNS) add-on", "type": "boolean", "description": "Optional paid add-on (default off). For each discovered hostname, perform a live DNS-over-HTTPS lookup to check whether it still resolves today, returning isLive, current A/AAAA IPs and any CNAME. Turns a historical certificate list into a live attack-surface map. Billed only per hostname that is actually resolved, and disabled for free users.", "default": false }, "withAiRisk": { "title": "AI attack-surface risk summary add-on", "type": "boolean", "description": "Optional paid AI add-on (default off). Uses AI to produce a concise 2-3 sentence attack-surface exposure assessment per domain, flagging risky subdomains (dev, staging, vpn, admin, internal), wildcard usage and issuer diversity. Billed once per domain, only when a usable summary is produced, and disabled for free users.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxy is recommended for the most reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }