{ "openapi": "3.0.1", "info": { "title": "SEO Audit Tool: On-Page Checker, Schema, Open Graph & llms.txt", "description": "Crawl a website (or a list of URLs) and audit on-page SEO: titles, meta descriptions, headings, canonical, indexability, hreflang, JSON-LD schema, Open Graph, image alt text, links and word count, with a 0-100 score per page and a site report with robots.txt, sitemap and llms.txt checks.", "version": "0.1", "x-build-id": "Eht2g73vNlxv07O5k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/latamdatatools~seo-onpage-audit/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-latamdatatools-seo-onpage-audit", "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/latamdatatools~seo-onpage-audit/runs": { "post": { "operationId": "runs-sync-latamdatatools-seo-onpage-audit", "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/latamdatatools~seo-onpage-audit/run-sync": { "post": { "operationId": "run-sync-latamdatatools-seo-onpage-audit", "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": { "startUrls": { "title": "Websites or URLs", "type": "array", "description": "One per line. In crawl mode each website is crawled from this URL (several start URLs of the same site are crawled together). In list mode only these URLs are audited.", "items": { "type": "string" } }, "mode": { "title": "Mode", "enum": [ "crawl", "list" ], "type": "string", "description": "Crawl the site following internal links (and sitemap URLs), or audit only the URLs you entered.", "default": "crawl" }, "maxPagesPerSite": { "title": "Max pages per site", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Crawl stops after this many pages (each audited page is one charged event).", "default": 30 }, "maxDepth": { "title": "Max link depth", "minimum": 0, "maximum": 20, "type": "integer", "description": "0 = only the start URLs, 1 = plus the pages they link to, and so on. Sitemap URLs count as depth 1.", "default": 5 }, "useSitemap": { "title": "Also use the sitemap to find pages", "type": "boolean", "description": "Seed the crawl with URLs from the sitemap (from robots.txt or /sitemap.xml).", "default": true }, "includeUrlPatterns": { "title": "Only URLs containing", "type": "array", "description": "Optional: crawl only URLs that contain one of these texts (e.g. /blog/), or /regex/.", "items": { "type": "string" } }, "excludeUrlPatterns": { "title": "Skip URLs containing", "type": "array", "description": "Optional: e.g. /tag/, ?page=.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset (from another Actor run)", "type": "string", "description": "Optional: read the URLs from an Apify dataset (field set in \"URL field\")." }, "csvUrl": { "title": "CSV file URL", "type": "string", "description": "Optional: public CSV with a header row (or one URL per line). Google Sheets links work if shared as \"Anyone with the link\"." }, "urlField": { "title": "URL field", "type": "string", "description": "Field / column with the URL.", "default": "url" }, "maxConcurrencyPerSite": { "title": "Requests in parallel per site", "minimum": 1, "maximum": 5, "type": "integer", "description": "Requests to one host are also spaced by the delay below and by Crawl-delay.", "default": 2 }, "maxSitesInParallel": { "title": "Sites in parallel", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many websites are audited at the same time.", "default": 2 }, "minDelayMs": { "title": "Delay between requests to the same host (ms)", "minimum": 250, "maximum": 10000, "type": "integer", "description": "Politeness delay. A longer Crawl-delay in robots.txt wins.", "default": 500 } } }, "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 } } } } } } } } } }