{ "openapi": "3.0.1", "info": { "title": "Keyword Density Checker: words, phrases and target keywords", "description": "Counts word and phrase frequency and density on many web pages or texts, with stop word handling in 69 languages, and checks target keywords for count, density, stuffing and placement in the title, meta description, headings, first 100 words, URL and image alt text.", "version": "0.1", "x-build-id": "EFjG9xce07hK5c4Js" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/examsens.ai~keyword-density/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-examsens.ai-keyword-density", "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/examsens.ai~keyword-density/runs": { "post": { "operationId": "runs-sync-examsens.ai-keyword-density", "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/examsens.ai~keyword-density/run-sync": { "post": { "operationId": "run-sync-examsens.ai-keyword-density", "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 analyze. Up to 10 MB each.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "texts": { "title": "Texts", "type": "array", "description": "Drafts or other text to analyze, one per entry.", "items": { "type": "string" } }, "targetKeywords": { "title": "Target keywords", "type": "array", "description": "Words or phrases to check on every page: count, density, and whether each appears in the title, meta description, H1, other headings, the first 100 words, the URL and image alt text.", "items": { "type": "string" } }, "contentScope": { "title": "Page text", "enum": [ "main", "all" ], "type": "string", "description": "Main content leaves out menus, footers, sidebars and cookie notices. All visible text counts everything on the page.", "default": "main" }, "includeTitleAndMeta": { "title": "Count title and meta description", "type": "boolean", "description": "Add the page title and meta description to the counted text.", "default": true }, "excludeStopwords": { "title": "Leave out stop words", "type": "boolean", "description": "Leave common words such as the, and, of out of the word list, and out of the start and end of phrases. They still count toward the total word count.", "default": true }, "language": { "title": "Stop word language", "type": "string", "description": "ISO 639-1 code such as en, de or fr. Auto picks the list that matches the text best.", "default": "auto" }, "extraStopwords": { "title": "Extra stop words", "type": "array", "description": "More words to leave out, such as your brand name.", "items": { "type": "string" } }, "maxPhraseWords": { "title": "Longest phrase (words)", "minimum": 1, "maximum": 3, "type": "integer", "description": "1 lists words only; 2 adds two word phrases; 3 adds three word phrases.", "default": 3 }, "topN": { "title": "Rows per list", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many words and phrases to list in each of the word, two word and three word lists.", "default": 30 }, "minFrequency": { "title": "Fewest occurrences", "minimum": 1, "type": "integer", "description": "List only words and phrases that appear at least this many times.", "default": 2 }, "minWordLength": { "title": "Shortest word (letters)", "minimum": 1, "type": "integer", "description": "Leave out shorter words.", "default": 3 }, "minDensity": { "title": "Target density low below (%)", "type": "string", "description": "A target keyword below this density is marked low.", "default": "0.5" }, "maxDensity": { "title": "Target density high above (%)", "type": "string", "description": "A target keyword above this density is marked high, a sign of keyword stuffing.", "default": "3" } } }, "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 } } } } } } } } } }