{
  "openapi": "3.0.1",
  "info": {
    "title": "Seznam.cz Keyword Planner – Search Volume (Hledanost) via Sklik",
    "description": "Keyword ideas and Seznam.cz search volume (hledanost) from the official Sklik API: monthly searches for 12 months, CPC in CZK, trend and peak month. Bulk stats for 10,000 keywords, optional Google + Seznam autocomplete expansion. Use your free Sklik token or ours. MCP-ready.",
    "version": "1.4",
    "x-build-id": "9zffR1HwmVCHtkItp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/budoucnost-ai~seznam-keyword-planner/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-budoucnost-ai-seznam-keyword-planner",
        "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/budoucnost-ai~seznam-keyword-planner/runs": {
      "post": {
        "operationId": "runs-sync-budoucnost-ai-seznam-keyword-planner",
        "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/budoucnost-ai~seznam-keyword-planner/run-sync": {
      "post": {
        "operationId": "run-sync-budoucnost-ai-seznam-keyword-planner",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "ideas",
              "stats",
              "url"
            ],
            "type": "string",
            "description": "\"ideas\" = keyword suggestions for each seed (Sklik keyword planner) with volumes. \"stats\" = Seznam.cz search volume for your exact keyword list (bulk, 100 per API call). \"url\" = an AI model (Claude by default – our hosted key or yours; or Gemini / OpenAI with your key) reads your web page(s) and proposes phrases customers search, then optionally gets Seznam volumes.",
            "default": "ideas"
          },
          "seeds": {
            "title": "Seed keywords (mode ideas)",
            "type": "array",
            "description": "One seed per line, in Czech as people type it on Seznam.cz (e.g. \"elektrokolo\"). Each seed returns up to maxIdeasPerSeed ideas; duplicates across seeds are delivered (and charged) once. Sklik syntax works per seed: \"phrase\" = phrase match, [exact] = only the seed itself.",
            "default": [
              "elektrokolo"
            ],
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords (mode stats)",
            "type": "array",
            "description": "Exact keywords to get Seznam.cz search volume for, one per line (up to 10,000). Keywords without Sklik data are returned with volume 0 unless minSearchVolume filters them out. Pasted Sklik syntax (\"…\", […]) is stripped automatically – Sklik stats would return 0 for it; negative keywords (-…) are skipped.",
            "items": {
              "type": "string"
            }
          },
          "maxIdeasPerSeed": {
            "title": "Max ideas per seed",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "How many suggestions to request from Sklik per seed (1–10,000).",
            "default": 20
          },
          "related": {
            "title": "Include related keywords",
            "type": "boolean",
            "description": "Also return related keywords that do not contain the seed (Sklik \"related\" switch). Off = only phrases containing the seed.",
            "default": false
          },
          "orderBy": {
            "title": "Order ideas by",
            "enum": [
              "avgSearchCount",
              "cpc",
              "score",
              "keyword"
            ],
            "type": "string",
            "description": "Which ideas Sklik returns first when there are more than maxIdeasPerSeed.",
            "default": "avgSearchCount"
          },
          "matchType": {
            "title": "Match type (mode ideas)",
            "enum": [
              "broad",
              "phrase",
              "exact"
            ],
            "type": "string",
            "description": "Like Sklik match types. Phrase sends the seed in double quotes to Sklik (e.g. \"bramac tegalit\" returns 72 ideas instead of 79 – reordered-word ideas are dropped). Exact returns just the seed's own volume. A seed typed with \"…\" or […] overrides this.",
            "default": "broad"
          },
          "expandEverySeed": {
            "title": "Expand every seed",
            "type": "boolean",
            "description": "Seeds are processed shortest first. On (default): every seed gets its own ideas even if an earlier seed already returned it. Off: a seed already returned by an earlier seed's ideas is skipped (cheaper, less long tail).",
            "default": true
          },
          "minSearchVolume": {
            "title": "Minimum search volume",
            "minimum": 0,
            "type": "integer",
            "description": "Drop keywords with fewer average monthly searches on Seznam.cz. Dropped rows are not saved and not charged. 0 = keep all.",
            "default": 0
          },
          "expandWithAutocomplete": {
            "title": "Expand with Google + Seznam autocomplete (add-on)",
            "type": "boolean",
            "description": "Mode ideas: also collect what Google (cs/CZ) and Seznam suggest while typing each seed, and look up their Seznam.cz volumes. Finds long-tail phrases Sklik suggest misses. Charged once per seed (autocomplete-expansion) plus each new keyword row.",
            "default": false
          },
          "autocompleteAlphabet": {
            "title": "Autocomplete: seed + a…z",
            "type": "boolean",
            "description": "With autocomplete expansion, also query \"seed a\" … \"seed z\" (27 queries per source per seed) for many more long-tail phrases.",
            "default": false
          },
          "negativeKeywords": {
            "title": "Negative keywords",
            "type": "array",
            "description": "Drop ideas and phrases containing these (case- and diacritics-insensitive, applied before any lookup or charge – dropped rows are free). křížovce = whole word (several words = all of them, any order), křížov* = word prefix, \"v křížovce\" = contiguous phrase, [levné tašky] = only that exact phrase. You can also type -křížovce among seeds or keywords.",
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort results by",
            "enum": [
              "value",
              "volume",
              "cpc",
              "keyword",
              "trend"
            ],
            "type": "string",
            "description": "Order of rows in the dataset. Value = cpcCzk × seznamSearchVolume (field valueCzk, a monthly click-value proxy). When maxItems or your charge limit caps the run, the top rows in this order are kept.",
            "default": "value"
          },
          "sortDirection": {
            "title": "Sort direction",
            "enum": [
              "desc",
              "asc"
            ],
            "type": "string",
            "description": "Default: descending (ascending for Keyword). Rows without the sort value always go last."
          },
          "startUrls": {
            "title": "Web pages (mode url)",
            "type": "array",
            "description": "Pages of the company or product to generate keywords for (e.g. homepage, category page). One AI analysis per URL, max 50.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "llmProvider": {
            "title": "AI provider",
            "enum": [
              "claude",
              "gemini",
              "openai"
            ],
            "type": "string",
            "description": "Claude: leave anthropicApiKey empty to use our hosted key (events url-analysis-hosted + llm-usage-hosted by actual token usage) or add your own key (event url-analysis only). Gemini and OpenAI always use your own key.",
            "default": "claude"
          },
          "anthropicApiKey": {
            "title": "Anthropic API key (optional)",
            "type": "string",
            "description": "Your own Claude API key from https://console.anthropic.com/settings/keys – Anthropic bills the tokens to you and this Actor charges only url-analysis. Empty = our hosted key, billed by usage. Stored encrypted, never logged."
          },
          "geminiApiKey": {
            "title": "Google Gemini API key",
            "type": "string",
            "description": "Your own Gemini API key (llmProvider gemini) – create it at https://aistudio.google.com/api-keys. Google bills usage to your key (free tier where available). Stored encrypted, never logged."
          },
          "openaiApiKey": {
            "title": "OpenAI API key",
            "type": "string",
            "description": "Your own OpenAI API key (llmProvider openai) from https://platform.openai.com/api-keys. Stored encrypted, never logged."
          },
          "llmModel": {
            "title": "AI model (optional)",
            "type": "string",
            "description": "Override the model. Defaults: claude-opus-5-5 (Claude), gemini-3.5-flash-lite (Gemini), gpt-6.1-sol (OpenAI). With the hosted Claude key only claude-opus-5-5, claude-sonnet-5-5 or claude-haiku-5-5 are allowed (Haiku is ~15× cheaper per unit, Sonnet half of Opus)."
          },
          "maxPageTokens": {
            "title": "Max page size (tokens)",
            "minimum": 2000,
            "maximum": 200000,
            "type": "integer",
            "description": "Claude only: how much of each fetched page the model reads (web_fetch max_content_tokens). Larger = more context and higher usage. Hosted key: max 60,000.",
            "default": 30000
          },
          "phraseTypes": {
            "title": "Phrase types",
            "enum": [
              "search",
              "ai-prompts",
              "both"
            ],
            "type": "string",
            "description": "search = short queries people type into Google or Seznam (get Seznam volume). ai-prompts = natural-language questions people ask AI assistants (no search volume exists – returned with null volume, free).",
            "default": "search"
          },
          "maxGeneratedPhrases": {
            "title": "Max generated phrases per URL",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Upper limit of phrases Gemini should return per URL.",
            "default": 200
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language of the generated phrases (ISO code, e.g. cs, sk, en, de).",
            "default": "cs"
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Market the phrases are for (ISO country code, e.g. CZ, SK).",
            "default": "CZ"
          },
          "targetAudience": {
            "title": "Target audience",
            "type": "string",
            "description": "Who searches – e.g. \"homeowners planning a new roof\". Empty = potential customers of the company behind the URL."
          },
          "sklikForGenerated": {
            "title": "Seznam data for generated phrases",
            "enum": [
              "none",
              "stats",
              "expand"
            ],
            "type": "string",
            "description": "stats = Seznam.cz volume for every generated search phrase (charged per row like other keywords). expand = also run Sklik keyword ideas for each phrase (maxIdeasPerSeed, shortest first, expandEverySeed applies). none = no Sklik lookup; rows are free (included in url-analysis).",
            "default": "stats"
          },
          "verifyAutocomplete": {
            "title": "Check phrases in Google / Seznam autocomplete",
            "type": "boolean",
            "description": "For each generated search phrase, check whether Google and Seznam autocomplete suggest it (or a longer variant) – fields inGoogleAutocomplete / inSeznamAutocomplete. A quick reality check of AI-invented phrases. Free.",
            "default": false
          },
          "sklikApiToken": {
            "title": "Your Sklik API token (optional, cheaper)",
            "type": "string",
            "description": "Your own Sklik API Drak token – generate it free at https://www.sklik.cz/settings in section \"Přístup k API Drak\" (any Sklik account, no ad spend needed). With your token rows cost $0.50 / 1,000 (event keyword). Leave empty to use our hosted token at $1.00 / 1,000 (event keyword-hosted). Stored encrypted, never logged."
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on saved (charged) keyword rows for the run.",
            "default": 10000
          },
          "useSharedCache": {
            "title": "Use shared monthly cache",
            "type": "boolean",
            "description": "Reuse Seznam volumes another run fetched this or last month (Sklik data updates monthly). Faster, same data; rows are marked fromCache. Off = always ask Sklik live.",
            "default": true
          },
          "cacheDays": {
            "title": "Max cache age (days)",
            "minimum": 0,
            "maximum": 62,
            "type": "integer",
            "description": "Ignore cached data older than this many days. 0 disables the cache.",
            "default": 30
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}