How do I get SERP data from Seznam?

We are happy to announce that our team has added Seznam to SERP API.

Seznam is the second largest search engine in the Czech Republic, with a local market share of 13.05% and millions of monthly users. In May 2022 alone, it had 293.7 million visits and is currently the most popular website in the country after Google.

With the Seznam SERP API endpoints, you can access the search engine’s SERP data at a low cost.

1 Call the Seznam Task POST endpoint.

POST https://api.dataforseo.com/v3/serp/seznam/organic/task_post

2 Specify the keyword for which you wish to receive SERP data in the keyword field.

Example: "keyword": "pizza prague"

3 Specify the location for which you want the API to return search results by adding the location_name or location_code field to the POST body.

You will receive the full list of supported locations by making a separate request to the Locations endpoint.

GET https://api.dataforseo.com/v3/serp/seznam/locations

Example: "location_code”: 21502

4 Specify the language to start a search session from by adding the language_name or language_code field to the POST body.

Note that Seznam SERP API supports only the Czech language ("language_code": "cs", "language_name": "Czech"). However, you can still specify the keyword parameter in any language.

5 Indicate the number of search results to be returned in the API response by adding the depth parameter to the POST body.

Default depth value: 10.

Maximum depth value: 500.

We strongly recommend setting the depth in the multiples of ten as our system processes ten results in a row. Thus, if you specify "depth": 11, our API will return 20 results, and your account will be charged for 20 results.

Your POST request should be structured as in the following example:

[
    {
        "language_name": "Czech",
        "location_code": 21502,
        "keyword": "pizza prague",
        "depth": 10
    }
]

6 Send the request and copy the Task ID from the response.

7 Use the copied task ID to retrieve results from the Task GET endpoint.

You may use the Task GET Regular or Task GET Advanced endpoint.

GET https://api.dataforseo.com/v3/serp/seznam/organic/task_get/regular/$id

GET https://api.dataforseo.com/v3/serp/seznam/organic/task_get/advanced/$id

The difference between the two is that the latter returns more data. The Regular endpoint provides organic results only, while its Advanced counterpart returns organic results with extra SERP features, including related searches, local packs, videos, images, shopping items, top stories, and featured snippets.

You can also receive SERP as raw HTML with the Task GET HTML endpoint.

GET https://api.dataforseo.com/v3/serp/seznam/organic/task_get/html/$id

Example of the API response (Task GET Advanced endpoint):

{
    "version": "0.1.20220428",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "1.0935 sec.",
    "cost": 0,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "06211200-2806-0066-0000-fc893784a5bf",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "1.0341 sec.",
            "cost": 0,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "seznam",
                "organic",
                "task_get",
                "advanced",
                "06211200-2806-0066-0000-fc893784a5bf"
            ],
            "data": {
                "api": "serp",
                "function": "task_get",
                "se": "seznam",
                "se_type": "organic",
                "language_name": "Czech",
                "location_code": 21502,
                "keyword": "pizza prague",
                "depth": 10,
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "pizza prague",
                    "type": "organic",
                    "se_domain": "search.seznam.cz",
                    "location_code": 21502,
                    "language_code": "cs",
                    "check_url": "https://search.seznam.cz/?q=pizza%20prague&count=10",
                    "datetime": "2022-06-21 09:00:27 +00:00",
                    "spell": null,
                    "item_types": [
                        "local_pack",
                        "organic",
                        "images",
                        "related_searches"
                    ],
                    "se_results_count": 0,
                    "items_count": 17,
                    "items": [
                        {
                            "type": "local_pack",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[3]/div[1]/div[1>",
                            "title": "Dáme jídlo",
                            "description": "1,6 (155) Rozvoz pizzy \nOtevřeno Praha, Libeň \n",
                            "domain": "www.damejidlo.cz",
                            "phone": null,
                            "url": "http://www.damejidlo.cz/#utm_source=search.seznam.cz&utm_medium=ppd&utm_content=hledani&utm_term=pizza%20prague&utm_campaign=firmy.cz-13063190",
                            "is_paid": false,
                            "rating": {
                                "rating_type": "CustomMax",
                                "value": null,
                                "votes_count": 155,
                                "rating_max": null
                            },
                            "cid": null,
                            "rectangle": null
                        },
                        {"type": "local_pack",...}
                    ]
                }
            ]
        }
    ]
}

Embed DataForSeo widget on your website

Width:

Height:

Embed code:

Copy Code

Preview: