{
  "openapi": "3.0.1",
  "info": {
    "title": "Seznam.cz Search Scraper – SERP with Sklik Ads, Firmy & Zboží",
    "description": "Seznam.cz search results (SERP) as clean JSON: organic results, Sklik ads with advertiser company, Firmy.cz businesses with contacts, Zboží.cz products and shop offers, news, AI answers, related searches, videos and wiki card. Rank tracking for your domains. MCP-ready.",
    "version": "1.3",
    "x-build-id": "dG7in6AHpOLeT7cZJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/budoucnost-ai~seznam-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-budoucnost-ai-seznam-search-scraper",
        "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-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-budoucnost-ai-seznam-search-scraper",
        "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-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-budoucnost-ai-seznam-search-scraper",
        "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": [
          "queries"
        ],
        "properties": {
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "What to search on search.seznam.cz – one query per line (e.g. elektrokolo, praha, iphone 16). Each query is one SERP.",
            "items": {
              "type": "string"
            }
          },
          "maxPagesPerQuery": {
            "title": "Pages per query",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many result pages to load per query (10 organic results per page, Seznam shows at most 50 pages). Ads, Firmy, Zboží and other blocks are mostly on page 1.",
            "default": 1
          },
          "includeBlocks": {
            "title": "Result blocks to save",
            "type": "array",
            "description": "Which SERP blocks become dataset rows (each block type is billed as listed in Pricing). Empty = all except images, Zboží shop offers (~35 rows per product query – add them for price monitoring) and Seznam AI answers (add ‘ai_answer’ – loaded from a Czech IP). The per-query summary always reports every block Seznam showed.",
            "items": {
              "type": "string",
              "enum": [
                "organic",
                "ad",
                "business",
                "product",
                "offer",
                "news",
                "ai_answer",
                "ai_question",
                "related",
                "video",
                "image",
                "wiki",
                "snippet"
              ],
              "enumTitles": [
                "Organic results",
                "Sklik ads (top + bottom)",
                "Firmy.cz businesses",
                "Zboží.cz products",
                "Zboží.cz shop offers (product ads)",
                "News articles",
                "Seznam AI answer / summary (full text + sources)",
                "AI questions (Seznam „Zvědavá AI“)",
                "Related searches",
                "Videos",
                "Images",
                "Wiki / knowledge card",
                "Featured snippet"
              ]
            },
            "default": [
              "organic",
              "ad",
              "business",
              "product",
              "news",
              "ai_question",
              "related",
              "video",
              "wiki",
              "snippet"
            ]
          },
          "trackDomains": {
            "title": "Track my domains (rank tracking)",
            "type": "array",
            "description": "Optional. Domains to find in the results (e.g. ekolo.cz). The summary row then shows each domain's organic rank, ad rank/placement and other blocks it appears in (Firmy businesses are matched by their website). Subdomains count.",
            "items": {
              "type": "string"
            }
          },
          "onlyTrackedDomains": {
            "title": "Save only rows of tracked domains",
            "type": "boolean",
            "description": "Cheap rank tracking: save only rows that match a tracked domain (plus the summary). You pay only for those rows.",
            "default": false
          },
          "includeSummary": {
            "title": "Add one summary row per query",
            "type": "boolean",
            "description": "Row with blockType = summary: total results, number of ads top/bottom, which blocks Seznam showed (AI, wiki card, Firmy, Zboží, news), related searches, and tracked-domain positions.",
            "default": true
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many dataset rows (cost cap).",
            "default": 100000
          },
          "maxConcurrency": {
            "title": "Parallel queries",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "How many queries run at once (1–5). Keep low to stay polite.",
            "default": 2
          },
          "aiAnswersFromCzechIp": {
            "title": "Load AI answers from a Czech IP",
            "type": "boolean",
            "description": "Seznam shows its AI answers only to visitors in the Czech Republic. When on (default) and ‘ai_answer’ is among the saved blocks, page 1 of each query is loaded through a Czech IP at no extra charge. Turn off only if you supply your own Czech proxy below.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed normally – Seznam answers directly. Turn on Apify Proxy only if runs start failing on blocked responses. A proxy set here is used for all requests, including AI answers (use a Czech IP if you want AI answers).",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}