{ "openapi": "3.0.1", "info": { "title": "Bulk URL Status & Redirect Checker", "description": "Check HTTP status codes and full redirect chains for thousands of URLs. Get the final URL, hops, loops, 302s and noindex headers, and verify expected redirects for site migrations. Works with Sitemap URL Extractor output. Respects robots.txt. $1 per 1,000 URLs.", "version": "0.0", "x-build-id": "mVLHRYgbpqIwAz3OX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kernfetch~url-status-redirect-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kernfetch-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/kernfetch~url-status-redirect-checker/runs": { "post": { "operationId": "runs-sync-kernfetch-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/kernfetch~url-status-redirect-checker/run-sync": { "post": { "operationId": "run-sync-kernfetch-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 (use Bulk edit to paste thousands). URLs without a scheme get https://. Duplicates are removed.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "Check the URLs stored in an Apify dataset, e.g. the output of Sitemap URL Extractor (kernfetch/sitemap-url-extractor). SUMMARY records are ignored." }, "datasetUrlField": { "title": "URL field in the dataset", "type": "string", "description": "Name of the field that contains the URL in the dataset items.", "default": "url" }, "redirectMap": { "title": "Expected redirects (migration QA)", "type": "array", "description": "One pair per line: old URL and expected final URL, separated by space, tab, comma, semicolon or '->'. Each old URL is checked and the result says whether it lands on the expected URL with a 2xx status.", "items": { "type": "string" } }, "method": { "title": "Request method", "enum": [ "HEAD_THEN_GET", "GET" ], "type": "string", "description": "HEAD then GET: lightest for the target site, falls back to GET when HEAD returns an error status. GET only: most accurate for servers that answer HEAD badly. The response body is never downloaded in either mode.", "default": "HEAD_THEN_GET" }, "maxRedirects": { "title": "Max redirects per URL", "minimum": 1, "maximum": 20, "type": "integer", "description": "Chains longer than this are reported as too_many_redirects.", "default": 10 }, "maxUrls": { "title": "Max URLs per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Safety cap on the number of URLs checked (and charged) in one run.", "default": 1000 }, "maxConcurrency": { "title": "Max parallel requests (all hosts)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum number of requests running at the same time across all hosts. Each host is still limited by the per-host settings below.", "default": 10 }, "perHostConcurrency": { "title": "Max parallel requests per host", "minimum": 1, "maximum": 3, "type": "integer", "description": "Kept low on purpose to be polite to each site.", "default": 2 }, "perHostDelayMs": { "title": "Min delay between requests to the same host (ms)", "minimum": 200, "maximum": 10000, "type": "integer", "description": "Minimum pause between two requests to the same host. Default 500 ms is about 2 URLs per second per host.", "default": 500 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 3, "maximum": 60, "type": "integer", "description": "Maximum time to wait for a response. URLs that time out are reported as unreachable (errorType 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 } } } } } } } } } }