{ "openapi": "3.0.1", "info": { "title": "Readability & SEO Content Checker – German + English", "description": "Bulk readability checker for URLs or text in English and German: Flesch Reading Ease, Flesch-Kincaid, Gunning Fog, SMOG, Flesch-Amstad, Wiener Sachtextformel, LIX, long sentences, passive voice, headings, title/meta length, keyword density and concrete fix hints.", "version": "1.0", "x-build-id": "r6BKjNjdlhMEB9DXa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fast_data_asap~readability-seo-content-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fast_data_asap-readability-seo-content-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/fast_data_asap~readability-seo-content-checker/runs": { "post": { "operationId": "runs-sync-fast_data_asap-readability-seo-content-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/fast_data_asap~readability-seo-content-checker/run-sync": { "post": { "operationId": "run-sync-fast_data_asap-readability-seo-content-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": "Page URLs", "type": "array", "description": "Web pages to check. Each page is fetched as plain HTML (no browser, robots.txt respected), the main content is extracted (navigation, footer and ads removed) and analysed.", "default": [ "https://en.wikipedia.org/wiki/Readability", "https://de.wikipedia.org/wiki/Lesbarkeit" ], "items": { "type": "string" } }, "texts": { "title": "Texts", "type": "array", "description": "Optional inline texts, e.g. drafts before publishing. Each entry: {\"id\": \"my-draft\", \"text\": \"...\"} and optionally its own \"targetKeyword\". Line breaks separate paragraphs. HTML is accepted too (then headings, title and meta description are checked).", "default": [ { "id": "entwurf-de", "text": "Gute Texte sind leicht zu lesen. Kurze Sätze helfen dabei, denn jeder Gedanke bekommt seinen eigenen Satz.\nWenn ein Satz dagegen mehr als fünfundzwanzig Wörter enthält und zudem mit verschachtelten Nebensätzen, Fachbegriffen sowie langen zusammengesetzten Hauptwörtern wie Bundesverfassungsgerichtsentscheidung gespickt ist, dann wird er von vielen Lesern nur langsam verstanden.\nDieser Absatz wurde von der Redaktion überarbeitet. Schreiben Sie aktiv und konkret: Wer macht was?" } ] }, "language": { "title": "Language", "enum": [ "auto", "en", "de" ], "type": "string", "description": "auto detects German or English per page/text. Set de or en to force the formulas for one language.", "default": "auto" }, "targetKeyword": { "title": "Target keyword (optional)", "type": "string", "description": "Focus keyword or phrase. Adds keyword count, density and whether it appears in the title, H1, meta description and first paragraph." }, "targetGrade": { "title": "Target grade level (optional)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum school grade your audience should need, e.g. 8. Compared with Flesch-Kincaid grade (English) or Wiener Sachtextformel (German, also a school-grade scale 4-15)." }, "includeText": { "title": "Include extracted main text", "type": "boolean", "description": "Adds the extracted main content as plain text (mainText, up to 100,000 characters), e.g. to verify the extraction or feed it to an AI model.", "default": false }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip URLs that the site's robots.txt disallows (they are returned with status blocked_by_robots and are free).", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages are fetched in parallel.", "default": 5 }, "maxRetries": { "title": "Retries per URL", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries on network errors and 5xx/429 responses.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Usually not needed for public articles and blogs." } } }, "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 } } } } } } } } } }