{
"openapi": "3.0.1",
"info": {
"title": "Bulk URL Health Checker - Status, Redirects & SSL",
"description": "Check a list of URLs for HTTP status, redirect chains, response time, content type, server and security headers, and the TLS certificate (issuer, expiry, days remaining). Find broken links and expiring certs. No browser.",
"version": "0.1",
"x-build-id": "64OmHHqtQJngl9Vo7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~url-health-checker/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-url-health-checker",
"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/scrapesage~url-health-checker/runs": {
"post": {
"operationId": "runs-sync-scrapesage-url-health-checker",
"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/scrapesage~url-health-checker/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-url-health-checker",
"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": {
"urls": {
"title": "URLs",
"type": "array",
"description": "URLs to check, one per line. A bare domain gets https://. Duplicates are collapsed. Leave empty and the run returns a small free sample.",
"items": {
"type": "string"
}
},
"urlsFromFile": {
"title": "Import URLs from a file (one per line)",
"type": "string",
"description": "Bulk-load URLs. Either paste the whole list (one per line), or give a single link to a public .txt/.csv, a Google Sheet/Drive share link, or an Apify key-value-store record. A file that cannot be read says so and charges nothing."
},
"checkSsl": {
"title": "Check TLS/SSL certificate",
"type": "boolean",
"description": "For https URLs, also open a TLS handshake and report the certificate issuer, validity, expiry date and days remaining. Turn off for a faster status-only run.",
"default": true
},
"concurrency": {
"title": "Concurrency",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many URLs to check in parallel.",
"default": 10
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those. Open the dropdown and tick, or type to filter (status, ssl, redirect).",
"items": {
"type": "string",
"enum": [
"type",
"url",
"finalUrl",
"status",
"ok",
"isBroken",
"reachable",
"error",
"responseTimeMs",
"isRedirect",
"redirectCount",
"redirectChain",
"contentType",
"contentLength",
"server",
"poweredBy",
"securityHeaders",
"hsts",
"sslValid",
"sslError",
"sslIssuer",
"sslSubject",
"sslValidFrom",
"sslValidTo",
"sslDaysRemaining",
"checkedAt"
],
"enumTitles": [
"Record type (type)",
"URL (url)",
"Final URL (finalUrl)",
"HTTP status (status)",
"OK 2xx/3xx (ok)",
"Is broken 4xx/5xx (isBroken)",
"Reachable (reachable)",
"Error (error)",
"Response time ms (responseTimeMs)",
"Is redirect (isRedirect)",
"Redirect count (redirectCount)",
"Redirect chain (redirectChain)",
"Content type (contentType)",
"Content length (contentLength)",
"Server (server)",
"X-Powered-By (poweredBy)",
"Security headers (securityHeaders)",
"HSTS (hsts)",
"SSL valid (sslValid)",
"SSL error (sslError)",
"SSL issuer (sslIssuer)",
"SSL subject (sslSubject)",
"SSL valid from (sslValidFrom)",
"SSL valid to (sslValidTo)",
"SSL days remaining (sslDaysRemaining)",
"Checked at (checkedAt)"
]
}
},
"maxItems": {
"title": "Max URLs",
"minimum": 1,
"type": "integer",
"description": "Maximum number of URLs to check in one run (after de-duplication).",
"default": 200
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. Checks run direct by default. Enable a proxy to check from a specific location or if a host blocks the checker."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}