{ "openapi": "3.0.1", "info": { "title": "AI Search Volume: ChatGPT & AI Overview Keyword Research", "description": "How often people use your keywords in ChatGPT and AI search, with a 12-month AI trend, next to Google search volume, CPC and difficulty, in 94 countries. Or find the real questions people ask AI about any topic, with the sites AI cites. No API key, no subscription.", "version": "0.1", "x-build-id": "U9VBRm4w10TeJXNFe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~ai-search-volume/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-ai-search-volume", "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/zaiq~ai-search-volume/runs": { "post": { "operationId": "runs-sync-zaiq-ai-search-volume", "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/zaiq~ai-search-volume/run-sync": { "post": { "operationId": "run-sync-zaiq-ai-search-volume", "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": [ "keywords" ], "properties": { "mode": { "title": "What to get", "enum": [ "volume", "questions" ], "type": "string", "description": "Volume measures each keyword (AI searches a month, 12-month AI trend, Google volume, CPC, difficulty). Questions finds the real ChatGPT prompts and Google AI Overview searches that contain each keyword, highest AI volume first.", "default": "volume" }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to measure (volume), or seed keywords to find questions for (questions: up to 20). One per line.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "One or more of the 94 countries covered (each keyword is measured in each country). ChatGPT questions exist for the United States only.", "items": { "type": "string", "enum": [ "AL", "DZ", "AO", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BE", "BO", "BA", "BR", "BG", "BF", "KH", "CM", "CA", "CL", "CO", "CR", "CI", "HR", "CY", "CZ", "DK", "EC", "EG", "SV", "EE", "FI", "FR", "DE", "GH", "GR", "GT", "HK", "HU", "IN", "ID", "IE", "IL", "IT", "JP", "JO", "KZ", "KE", "LV", "LT", "MY", "MT", "MX", "MD", "MC", "MA", "MM", "NL", "NZ", "NI", "NG", "MK", "NO", "PK", "PA", "PY", "PE", "PH", "PL", "PT", "RO", "SA", "SN", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SE", "CH", "TW", "TH", "TN", "TR", "UA", "AE", "GB", "US", "UY", "VE", "VN" ], "enumTitles": [ "Albania", "Algeria", "Angola", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belgium", "Bolivia", "Bosnia and Herzegovina", "Brazil", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Chile", "Colombia", "Costa Rica", "Cote d'Ivoire", "Croatia", "Cyprus", "Czechia", "Denmark", "Ecuador", "Egypt", "El Salvador", "Estonia", "Finland", "France", "Germany", "Ghana", "Greece", "Guatemala", "Hong Kong", "Hungary", "India", "Indonesia", "Ireland", "Israel", "Italy", "Japan", "Jordan", "Kazakhstan", "Kenya", "Latvia", "Lithuania", "Malaysia", "Malta", "Mexico", "Moldova", "Monaco", "Morocco", "Myanmar (Burma)", "Netherlands", "New Zealand", "Nicaragua", "Nigeria", "North Macedonia", "Norway", "Pakistan", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Romania", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sweden", "Switzerland", "Taiwan", "Thailand", "Tunisia", "Turkiye", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Venezuela", "Vietnam" ] }, "default": [ "US" ] }, "language": { "title": "Language", "type": "string", "description": "Optional language code or name (en, de, fr, Spanish...). Empty = each country's main language." }, "includeGoogleMetrics": { "title": "Add Google search volume, CPC, difficulty and intent", "type": "boolean", "description": "Volume mode: Google's monthly searches, CPC, competition, keyword difficulty, intent and 12-month trend next to the AI numbers, and the AI-to-Google ratio. Same price.", "default": true }, "minAiSearchVolume": { "title": "Minimum AI searches a month", "minimum": 0, "type": "integer", "description": "Leave out keywords or questions below this AI search volume. Left-out keywords are not charged.", "default": 0 }, "platform": { "title": "AI platform (questions)", "enum": [ "both", "chat_gpt", "google" ], "type": "string", "description": "Questions mode. ChatGPT prompts are what people type into ChatGPT (United States, English); Google AI Overview searches are the Google searches that show an AI answer (94 countries). Each platform is one question search per keyword.", "default": "both" }, "maxQuestions": { "title": "Questions per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Questions mode: how many questions per seed keyword, platform and country, highest AI search volume first.", "default": 100 } } }, "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 } } } } } } } } } }