{ "openapi": "3.0.1", "info": { "title": "Bulk URL Status Checker: Redirect Chain & Response Time", "description": "Check the HTTP status of up to 100,000 URLs: every redirect hop with its status and timing, the final URL, https check, key headers, plus page title, meta robots and canonical. Flags loops, long chains, 404s, timeouts and DNS errors. Pay per URL answered.", "version": "1.0", "x-build-id": "Ry2cbFweknouAWkAD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/private_image_hg9~bulk-url-status-redirect-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-private_image_hg9-bulk-url-status-redirect-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/private_image_hg9~bulk-url-status-redirect-checker/runs": { "post": { "operationId": "runs-sync-private_image_hg9-bulk-url-status-redirect-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/private_image_hg9~bulk-url-status-redirect-checker/run-sync": { "post": { "operationId": "run-sync-private_image_hg9-bulk-url-status-redirect-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 to check", "type": "array", "description": "One URL per line, like https://example.com/page or http://example.org. A URL without http:// or https:// is checked as https://. Repeated URLs are checked once. Up to 100,000 URLs per run, together with the pasted list below.", "items": { "type": "string" } }, "urlsText": { "title": "Or paste a list", "type": "string", "description": "Paste URLs from a spreadsheet or a text file: one per line, or separated by spaces or tabs. Quotes, and a comma or semicolon at the end of a URL are removed. Combined with the list above." }, "method": { "title": "Request method", "enum": [ "HEAD_THEN_GET", "GET" ], "type": "string", "description": "HEAD then GET (default): a light HEAD request for each hop, and a GET when the server refuses or fails HEAD (some answer HEAD with 405 or 404 by mistake). GET only: always GET, for servers that answer HEAD wrongly; the page body is still not downloaded, except the start of HTML pages for their title.", "default": "HEAD_THEN_GET" }, "followRedirects": { "title": "Follow redirects", "type": "boolean", "description": "Follow 301, 302, 303, 307 and 308 redirects, up to 10 hops, and report every hop. Off: report the first answer only (a redirect shows its target in hops[0].location).", "default": true }, "readPageDetails": { "title": "Read page title, meta robots and canonical", "type": "boolean", "description": "For final pages that are HTML and answer 2xx, read the first 512 KB to get the , meta robots and rel=canonical. Only done where the site's robots.txt allows this tool to read the page. Off: status and headers only (faster, fewer requests).", "default": true }, "userAgent": { "title": "User-Agent", "enum": [ "tool", "browser" ], "type": "string", "description": "The tool's own User-Agent (UrlStatusCheckBot) names it honestly. Some sites answer bots differently (often 403); the browser option sends a common desktop Chrome User-Agent to see what a visitor gets.", "default": "tool" }, "maxRequestsPerSecondPerHost": { "title": "Requests per second per host", "minimum": 1, "maximum": 10, "type": "integer", "description": "The most requests sent each second to any one host. A host that answers 429 (too many requests) is slowed down further, down to one request every 2 seconds. Different hosts are checked in parallel.", "default": 3 }, "timeoutSecs": { "title": "Timeout per request (seconds)", "minimum": 1, "maximum": 60, "type": "integer", "description": "How long to wait for a server's answer to one request. A URL with all its hops and retries may take up to 4 times this (at least 30 seconds) before it is reported as a timeout.", "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 }, "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 } } } } } } } } } }