**Seznam.cz** (or just _Seznam_, which means _list_ in English) is a [web portal](https://en.wikipedia.org/wiki/Web_portal "Web portal") and [search engine](https://en.wikipedia.org/wiki/Search_engine "Search engine") in the [Czech Republic](https://en.wikipedia.org/wiki/Czech_Republic "Czech Republic"). Founded in 1996 by [Ivo Lukačovič](https://en.wikipedia.org/wiki/Ivo_Luka%C4%8Dovi%C4%8D "Ivo Lukačovič") in [Prague](https://en.wikipedia.org/wiki/Prague "Prague") as the first web portal in the Czech Republic. Seznam started with a [search engine](https://en.wikipedia.org/wiki/Search_engine "Search engine") and an internet version of [yellow pages](https://en.wikipedia.org/wiki/Yellow_pages "Yellow pages"). Today, Seznam runs almost 30 different web services and associated brands. Seznam had more than 6 million real users per month at the end of 2014.[[4]](https://en.wikipedia.org/wiki/Seznam.cz#cite_note-4) Among the most popular services, according to NetMonitor, are its homepage seznam.cz, email.cz, search.seznam.cz and its yellow pages firmy.cz.
### 💼 Tutorial
#### 👉 Parameters
| Input| Type | Description |
|-|-|-|
| `query` | ***string*** | Query, Search Terms or URL |
| `limit` | ***integer*** | Number of results (per-query)|
#### 👉 Basic Usage
Search business
```yaml
{ "query": "massage", "limit": 10 }
````
Autodetect Firmy URL for possible contents
```yaml
{ "query": "https://www.firmy.com/?q=sponge bobs", "limit": 10 }
```
#### 👉 Advanced Usage
***FIRMY Query Language (FQL) :***
```html
[ [ 
# Actor input Schema
## `query` (type: `string`):
💡 Search term, URL or Listing-ID
## `location` (type: `string`):
No description
## `language` (type: `string`):
No description
## `limit` (type: `integer`):
💡 Number of results
## `include_detail` (type: `boolean`):
💡 Get more detailed information (email, gallery, tags, etc.)
## `review_num` (type: `integer`):
💡 Number of reviews to fetch
## `review_sort` (type: `string`):
💡 Sort reviews
## `load_filters` (type: `boolean`):
💡 Get available categories & filters. (The results will show up in Logs)
## `category` (type: `string`):
💡 Category ID or Path. (example: Automotive/Automotive-services/Auto-service-and-repair)Use Show Filters to show available Filters and Related Categories ## `filters` (type: `array`): 💡 List of filters example:
foto-provozovny
## `dev_proxy_config` (type: `object`):
💡 Supported protocol:HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:portExample:
socks5://example.com:9000
## `dev_custom_headers` (type: `array`):
💡 Additional HTTP Headers
## `dev_custom_cookies` (type: `array`):
💡 Additional HTTP Cookies
## `dev_transform_fields` (type: `array`):
💡 Transform the resulting output. Select only needed fields.For nested object use DOT. For example:
address.streetAddress
For nested array use NUMBER (index of array element starting from index=0). For example:
images.0.url## `dev_dataset_name` (type: `string`): 💡 Save results into custom named Dataset, use mask to customize dataset name
{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)This masks can be used to autogenerate Dataset Name.
example:
data-{DATE}Depending on today date the dataset name will be:
data-20230603default:
data-{ACTOR}-{DATE}-{TIME}
## `dev_dataset_clear` (type: `boolean`):
Clear Dataset before insert/update.
## `dev_no_strip` (type: `boolean`):
💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)
## Actor input object example
```json
{
"query": "Car Service",
"limit": 5
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '(email, gallery, tags, etc.)"
},
"review_num": {
"title": "Include Reviews",
"type": "integer",
"description": "💡 Number of reviews to fetch"
},
"review_sort": {
"title": "Sort Reviews",
"enum": [
"top",
"new",
"best",
"worst",
"photo"
],
"type": "string",
"description": "💡 Sort reviews"
},
"load_filters": {
"title": "Enable",
"type": "boolean",
"description": "💡 Get available categories & filters. (The results will show up in Logs)"
},
"category": {
"title": "Category",
"type": "string",
"description": "💡 Category ID or Path. (example: Automotive/Automotive-services/Auto-service-and-repair)Use Show Filters to show available Filters and Related Categories" }, "filters": { "title": "Filters", "type": "array", "description": "💡 List of filters example:
foto-provozovny",
"items": {
"type": "string"
}
},
"dev_proxy_config": {
"title": "🌐 PROXY NETWORKING",
"type": "object",
"description": "💡 Supported protocol:HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:portExample:
socks5://example.com:9000"
},
"dev_custom_headers": {
"title": "📜 HTTP HEADERS",
"type": "array",
"description": "💡 Additional HTTP Headers",
"items": {
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"title": "Key"
},
"value": {
"type": "string",
"title": "Value"
}
}
}
},
"dev_custom_cookies": {
"title": "🍰 HTTP COOKIES",
"type": "array",
"description": "💡 Additional HTTP Cookies",
"items": {
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"title": "Key"
},
"value": {
"type": "string",
"title": "Value"
}
}
}
},
"dev_transform_fields": {
"title": "♻️ CUSTOM FIELD",
"type": "array",
"description": "💡 Transform the resulting output. Select only needed fields.For nested object use DOT. For example:
address.streetAddress
For nested array use NUMBER (index of array element starting from index=0). For example:
images.0.url", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "dev_dataset_name": { "title": "📁 CUSTOM STORAGE", "type": "string", "description": "💡 Save results into custom named Dataset, use mask to customize dataset name
{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)This masks can be used to autogenerate Dataset Name.
example:
data-{DATE}Depending on today date the dataset name will be:
data-20230603default:
data-{ACTOR}-{DATE}-{TIME}"
},
"dev_dataset_clear": {
"title": "Clear Storage",
"type": "boolean",
"description": "Clear Dataset before insert/update."
},
"dev_no_strip": {
"title": "Disable data cleansing",
"type": "boolean",
"description": "💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)"
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```