{ "openapi": "3.0.1", "info": { "title": "Image Alt Text Checker: Missing Alt & Image SEO Audit", "description": "Scan any website and extract every image's alt text and metadata. Find images with missing or empty alt attributes for SEO and WCAG accessibility. No AI cost, fast and cheap.", "version": "0.1", "x-build-id": "14zxC26M9OrmJYvW0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/raional~image-alt-text-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-raional-image-alt-text-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/raional~image-alt-text-checker/runs": { "post": { "operationId": "runs-sync-raional-image-alt-text-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/raional~image-alt-text-checker/run-sync": { "post": { "operationId": "run-sync-raional-image-alt-text-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Website URLs to scan", "type": "array", "description": "Website pages to check for image alt text and metadata. Only scan sites you own or have permission to analyze.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "onlyMissingAlt": { "title": "Only images missing alt text", "type": "boolean", "description": "Report only images whose alt attribute is missing or empty (the accessibility/SEO issues). Turn off to extract metadata for every image on the page.", "default": true }, "maxImages": { "title": "Max images per run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety cap on how many images to check in one run.", "default": 500 }, "maxPagesPerCrawl": { "title": "Max pages per site", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many pages to crawl per start URL (same domain). 1 = just the given page. Acts as the safety cap when 'Scan entire site' is on (floored at 100 automatically).", "default": 1 }, "scanEntireSite": { "title": "Scan entire site", "type": "boolean", "description": "Follow internal links and check sitemap.xml to scan the whole site, not just the URL(s) above — e.g. scanning mushyrecipe.com also finds and checks mushyrecipe.com/blog automatically, even if it's buried a level inside the domain.", "default": false }, "generateAiDescriptions": { "title": "AI-generate SEO meta descriptions for missing-alt images (paid add-on)", "type": "boolean", "description": "For each image missing or with empty alt text, use AI vision to write an SEO-optimized description of what the image shows — added as an extra 'aiMetaDescription' column. Billed separately per description generated (see Pricing).", "default": false }, "aiModel": { "title": "AI vision model (advanced)", "type": "string", "description": "Model used when 'AI-generate SEO meta descriptions' is on. Defaults to a fast, cheap vision model.", "default": "google/gemini-2.5-flash-lite" } } }, "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 } } } } } } } } } }