{ "openapi": "3.0.1", "info": { "title": "Domain & SSL Expiry Monitor", "description": "Monitor domain registration and SSL certificate expiry across every site you own or manage. Days remaining, registrar, certificate issuer, trust problems and an alert level per domain, in one dataset.", "version": "0.1", "x-build-id": "XpAVi96sYgeEqbTcK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arched_friend~domain-ssl-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arched_friend-domain-ssl-monitor", "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/arched_friend~domain-ssl-monitor/runs": { "post": { "operationId": "runs-sync-arched_friend-domain-ssl-monitor", "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/arched_friend~domain-ssl-monitor/run-sync": { "post": { "operationId": "run-sync-arched_friend-domain-ssl-monitor", "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": [ "domains" ], "properties": { "domains": { "title": "Domains", "type": "array", "description": "The domains to check, one per line. A bare domain, a full URL or a subdomain all work, so example.com, https://www.example.com/pricing and shop.example.co.uk are all accepted. Add a port such as mail.example.com:8443 to check a certificate that is not served on 443.", "items": { "type": "string" } }, "domainWarningDays": { "title": "Domain expiry warning window", "minimum": 1, "maximum": 365, "type": "integer", "description": "Raise a warning when the domain registration expires within this many days. Registrars usually want 30 days of notice before a renewal, so 30 is a safe default.", "default": 30 }, "certWarningDays": { "title": "Certificate expiry warning window", "minimum": 1, "maximum": 365, "type": "integer", "description": "Raise a warning when the SSL certificate expires within this many days. Let's Encrypt renews at 30 days and most automation retries for a fortnight, so 14 catches a renewal that has quietly stopped working.", "default": 14 }, "onlyProblems": { "title": "Only return problems", "type": "boolean", "description": "Drop every healthy domain and return only the rows with a warning, a critical alert or an error. Turn this on for a scheduled run so the dataset is an inbox, not a report.", "default": false }, "checkRegistry": { "title": "Check the domain registration", "type": "boolean", "description": "Look the domain up at its registry over RDAP for the expiry date, registrar, transfer lock, DNSSEC and nameservers. Turn it off to check certificates only.", "default": true }, "checkCertificate": { "title": "Check the SSL certificate", "type": "boolean", "description": "Open a TLS connection to the host and read the certificate it serves, including issuer, expiry, covered hostnames and any trust problem. Turn it off to check registrations only.", "default": true }, "concurrency": { "title": "Domains in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many domains to check at once. Registries rate limit per IP address, so raise this only for large lists and lower it if lookups start failing.", "default": 5 }, "timeoutSeconds": { "title": "Timeout per check", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for a registry response or a TLS handshake before giving up on that domain and reporting it as unreachable.", "default": 15 } } }, "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 } } } } } } } } } }