Dokumentácia API Semscraper

Informácie
Limity hovorov
Verzie Google
Zoznam verzií
SERPS
Vyhľadávacie dotazy Google
Vyhľadávanie v Mapách Google
ID dotazov
Obnovenie SERP
Spätné volanie URL
Stav spracovania SERP
Fakturácia
Zostávajúci kredit
Spôsoby platby

Informácie

Obmedzenie počtu volaní API

GET : 500 appels par minute
POST : 500 appels par minute

Verzie Google

Získanie parametrov umiestnenie a jazyk potrebných na načítanie výsledkov vyhľadávania Google SERP.

get

https://api.semscraper.com/v1/serp/google/location

Povolenia : Bearer {api_key}

Žiadosť
Úspešná reakcia

Status: 200 OK
{
    "status": "success",
    "request_ms": 17,
    "count": 372,
    "data": [
        {
            "location": "en",
            "language": "en",
            "host": "google.com",
            "name": "World Wide Web"
        },
        {
            "location": "fr",
            "language": "fr",
            "host": "google.fr",
            "name": "France"
        }
}
{

    "status": "success",

    "request_ms": 17,

    "count": 372,

    "data": [

        {

            "location": "en",

            "language": "en",

            "host": "google.com",

            "name": "World Wide Web"

        },

        {

            "location": "fr",

            "language": "fr",

            "host": "google.fr",

            "name": "France"

        }

}

SERP

Vytváranie dotazov vyhľadávania Google SERP

Údaje sa musia odoslať v poli JSON. Každý prvok musí obsahovať tieto polia.

Limit

Pole JSON môže obsahovať 100 prvkov, takže jedným volaním môžete vytvoriť 100 prehľadov SERP.

post

https://api.semscraper.com/v1/serp

Povolenia : Bearer {api_key}

Parametre

search_engine

Požadované

string

Výber vyhľadávača :
Vyhľadávanie Google (hodnota: google_search)

keyword

Požadované

string

Kľúčové slová na vyhľadávanie vo vyhľadávači

device

Požadované

string

Výber substrátu :
Počítač (hodnota: stolný)
Mobilný telefón (hodnota: mobilný telefón)

depth

Požadované

integer

Hĺbka stránky, načítame SERPy Google so stránkovaním. Tento parameter musí byť v rozsahu od 1 (približne 10 výsledkov) do 10 (približne 100 výsledkov).

location

Požadované

string

Kód umiestnenia vyhľadávača

language

Požadované

string

Jazyk vyhľadávača

geolocation

string

Umožňuje geolokalizovať SERP Google. Môžete napríklad uviesť mesto, departement alebo krajinu oddelené čiarkou.

priority

integer

Slúži na určenie priority vašich požiadaviek, ktoré sa spracúvajú v zostupnom poradí podľa priority. Hodnota od 1 (nízka) do 10 (vysoká).

callback_url

string

Umožňuje zadať adresu URL, na ktorú vám po spracovaní kľúčového slova pošleme výsledky.

Result block types

Possible values of the type field. A block is only present in the response when Google displays it for the requested keyword.

Results and ads

organic

Organic result

Standard organic search result.

sitelinks

Sitelinks

Secondary link attached to an organic result.

paid_top

Top ad

Paid ad above the organic results.

paid_bottom

Bottom ad

Paid ad below the organic results.

Rich blocks

featured_snippet

Featured snippet

Highlighted snippet above the organic results.

knowledge_graph

Knowledge panel

Item from the panel shown on the right of the SERP.

images

Images

Thumbnail from the images block.

videos

Videos

Video from the videos block.

top_stories

Related searches

Related search suggested at the bottom of the page.

find_results_on

Find results on

Link from the Find results on block.

location_sites

Location sites

Site listed in a location-related block.

AI Overview

ai_overview_citation

Citation

Brand cited in the AI-generated text.

ai_overview_citation_source

Citation source

Source of a citation, shown on hover over it.

ai_overview_panel

Source panel

Site listed in the side panel of sources.

Žiadosť
Úspešná reakcia
Chybová odpoveď

Status: 200 OK
{
    "status": "success",
    "request_ms": 40,
    "count": 1,
    "currency": "EUR",
    "total_cost": 2.0e-5,
    "data": [
        {
            "id": "SERP_ID",
            "status": "pending",
            "keyword": "example keyword",
            "device": "mobile",
            "location": "fr",
            "language": "fr",
            "depth": 1,
            "geolocation": false,
            "priority": 1,
            "callback_url": null,
            "cost": 2.0e-51,
            "_links": {
                "json": {
                    "href": "/serp?ids=SERP_ID&output=json",
                    "method": "GET",
                    "type": "application/json"
                },
                "html": {
                    "href": "/serp?ids=SERP_ID&output=html",
                    "method": "GET",
                    "type": "application/json"
                }
            }
        }
    ]
}
{

    "status": "success",

    "request_ms": 40,

    "count": 1,

    "currency": "EUR",

    "total_cost": 2.0e-5,

    "data": [

        {

            "id": "SERP_ID",

            "status": "pending",

            "keyword": "example keyword",

            "device": "mobile",

            "location": "fr",

            "language": "fr",

            "depth": 1,

            "geolocation": false,

            "priority": 1,

            "callback_url": null,

            "cost": 2.0e-51,

            "_links": {

                "json": {

                    "href": "/serp?ids=SERP_ID&output=json",

                    "method": "GET",

                    "type": "application/json"

                },

                "html": {

                    "href": "/serp?ids=SERP_ID&output=html",

                    "method": "GET",

                    "type": "application/json"

                }

            }

        }

    ]

}

Status: 400 Bad Request
{
    "error": "Bad Request",
    "message": "DESCRIPTION_OF_ERROR",
    "code": 400
}
{

    "error": "Bad Request",

    "message": "DESCRIPTION_OF_ERROR",

    "code": 400

}

Vytváranie dotazov v službe Google Maps SERP

Údaje sa musia odoslať v poli JSON. Každý prvok musí obsahovať tieto polia.

Limit

Pole JSON môže obsahovať 100 prvkov, takže jedným volaním môžete vytvoriť 100 prehľadov SERP.

post

https://api.semscraper.com/v1/serp

Povolenia : Bearer {api_key}

Parametre

search_engine

Požadované

string

Výber vyhľadávača :
Mapy Google (hodnota: google_maps)

keyword

Požadované

string

Kľúčové slová na vyhľadávanie vo vyhľadávači

depth

Požadované

integer

Hĺbka stránky, načítame SERPy Google so stránkovaním. Tento parameter musí byť v rozsahu od 1 (približne 10 výsledkov) do 10 (približne 100 výsledkov).

location

Požadované

string

Kód umiestnenia vyhľadávača

language

Požadované

string

Jazyk vyhľadávača

geolocation

string

Umožňuje geolokalizovať SERP Google. Môžete napríklad uviesť mesto, departement alebo krajinu oddelené čiarkou.

priority

integer

Slúži na určenie priority vašich požiadaviek, ktoré sa spracúvajú v zostupnom poradí podľa priority. Hodnota od 1 (nízka) do 10 (vysoká).

callback_url

string

Umožňuje zadať adresu URL, na ktorú vám po spracovaní kľúčového slova pošleme výsledky.

Žiadosť
Úspešná reakcia
Chybová odpoveď

Status: 200 OK
{
    "status": "success",
    "request_ms": 40,
    "count": 1,
    "currency": "EUR",
    "total_cost": 2.0e-5,
    "data": [
        {
            "id": "SERP_ID",
            "status": "pending",
            "keyword": "example keyword",
            "device": "mobile",
            "location": "fr",
            "language": "fr",
            "depth": 1,
            "geolocation": false,
            "priority": 1,
            "callback_url": null,
            "cost": 2.0e-51,
            "_links": {
                "json": {
                    "href": "/serp?ids=SERP_ID&output=json",
                    "method": "GET",
                    "type": "application/json"
                },
                "html": {
                    "href": "/serp?ids=SERP_ID&output=html",
                    "method": "GET",
                    "type": "application/json"
                }
            }
        }
    ]
}
{

    "status": "success",

    "request_ms": 40,

    "count": 1,

    "currency": "EUR",

    "total_cost": 2.0e-5,

    "data": [

        {

            "id": "SERP_ID",

            "status": "pending",

            "keyword": "example keyword",

            "device": "mobile",

            "location": "fr",

            "language": "fr",

            "depth": 1,

            "geolocation": false,

            "priority": 1,

            "callback_url": null,

            "cost": 2.0e-51,

            "_links": {

                "json": {

                    "href": "/serp?ids=SERP_ID&output=json",

                    "method": "GET",

                    "type": "application/json"

                },

                "html": {

                    "href": "/serp?ids=SERP_ID&output=html",

                    "method": "GET",

                    "type": "application/json"

                }

            }

        }

    ]

}

Status: 400 Bad Request
{
    "error": "Bad Request",
    "message": "DESCRIPTION_OF_ERROR",
    "code": 400
}
{

    "error": "Bad Request",

    "message": "DESCRIPTION_OF_ERROR",

    "code": 400

}

Zoznam identifikátorov (ID) pre dokončené SERPy, ktoré ste ešte nevyzdvihli.

Táto metóda umožňuje získať ID všetkých SERP, ktoré už boli spracované, ale ešte neboli načítané. Pomocou týchto ID potom môžete vyvolať metódu načítania SERP.

get

https://api.semscraper.com/v1/serp

Povolenia : Bearer {api_key}

Žiadosť
Úspešná reakcia

Status: 200 OK
{
    "status": "success",
    "request_ms": 40,
    "count": 2,
    "data": [
        {
            "id": "SERP_ID",
            "status": "done",
            "keyword": "example keyword",
            "device": "desktop",
            "location": "fr",
            "language": "fr",
            "depth": 5,
            "geolocation": false,
            "callback_url": "",
            "cost": "0.00010",
            "_links": {
                "json": {
                    "href": "/serp?ids=SERP_ID&output=json",
                    "method": "GET",
                    "type": "application/json"
                },
                "html": {
                    "href": "/serp?ids=SERP_ID&output=html",
                    "method": "GET",
                    "type": "application/json"
                }
            }
        },
        {
            "id": "SERP_ID",
            "status": "done",
            "keyword": "example keyword",
            "device": "mobile",
            "location": "fr",
            "language": "fr",
            "depth": 5,
            "geolocation": false,
            "callback_url": "",
            "cost": "0.00010",
            "_links": {
                "json": {
                    "href": "/serp?ids=SERP_ID&output=json",
                    "method": "GET",
                    "type": "application/json"
                },
                "html": {
                    "href": "/serp?ids=SERP_ID&output=html",
                    "method": "GET",
                    "type": "application/json"
                }
            }
        }
    ]
}
{

    "status": "success",

    "request_ms": 40,

    "count": 2,

    "data": [

        {

            "id": "SERP_ID",

            "status": "done",

            "keyword": "example keyword",

            "device": "desktop",

            "location": "fr",

            "language": "fr",

            "depth": 5,

            "geolocation": false,

            "callback_url": "",

            "cost": "0.00010",

            "_links": {

                "json": {

                    "href": "/serp?ids=SERP_ID&output=json",

                    "method": "GET",

                    "type": "application/json"

                },

                "html": {

                    "href": "/serp?ids=SERP_ID&output=html",

                    "method": "GET",

                    "type": "application/json"

                }

            }

        },

        {

            "id": "SERP_ID",

            "status": "done",

            "keyword": "example keyword",

            "device": "mobile",

            "location": "fr",

            "language": "fr",

            "depth": 5,

            "geolocation": false,

            "callback_url": "",

            "cost": "0.00010",

            "_links": {

                "json": {

                    "href": "/serp?ids=SERP_ID&output=json",

                    "method": "GET",

                    "type": "application/json"

                },

                "html": {

                    "href": "/serp?ids=SERP_ID&output=html",

                    "method": "GET",

                    "type": "application/json"

                }

            }

        }

    ]

}

Obnovenie výsledkov vyhľadávania Google SERP prostredníctvom ich ID

Získanie viacerých SERP v jednom volaní (vo formáte JSON alebo HTML) zadaním niekoľkých ID oddelených čiarkou.

Limit

Môžete zadať maximálne 100 ID, čo vám umožní získať 100 SERP v rámci jedného volania.

get

https://api.semscraper.com/v1/serp?ids=id1,id2&output=json

Povolenia : Bearer {api_key}

Parametre

ids

Požadované

string

Zoznam ID oddelených čiarkou.

output

Požadované

string

Výber výstupného formátu :
JSON (hodnota: json)
HTML (hodnota: html)

Formát výsledku

Google Search
Google Maps

type

string

Typ výsledkového bloku (organické výsledky, videá, obrázky, people_also_ask, local_pack...)

rank_type

integer

Pozícia prvku v rámci jeho vlastného typu bloku (napr.: 3. organický výsledok = 3)

rank_serp

integer

Absolútna pozícia v kompletnom SERP, vrátane všetkých blokov, podľa skutočnej vertikálnej polohy na stránke (v pixeloch)

page

integer

Číslo strany v SERP, na ktorej sa prvok nachádza

pixel

integer

Vertikálna poloha prvku na stránke, v pixeloch od hornej hrany

domain

string

Doména URL

url

string

URL výsledku

title

string

Zobrazený názov výsledku

description

string

Popis / zobrazený výňatok z výsledku

brand

string

Cited brand, or the source label as displayed by Google. Only on ai_overview_citation, ai_overview_citation_source and ai_overview_panel blocks. On a citation the URL is often empty, making the brand the only information carried by the item.

visible

boolean

Whether the item is shown straight away in the AI Overview (true) or only after expanding it (false). Only on AI Overview blocks. Always false for ai_overview_citation_source, which appears on hover over a citation.

rank_type

integer

Pozícia prvku v rámci jeho vlastného typu bloku (napr.: 3. organický výsledok = 3)

rank_serp

integer

Absolútna pozícia v kompletnom SERP, vrátane všetkých blokov, podľa skutočnej vertikálnej polohy na stránke (v pixeloch)

page

integer

Číslo strany v SERP, na ktorej sa prvok nachádza

pixel

integer

Vertikálna poloha prvku na stránke, v pixeloch od hornej hrany

title

string

Zobrazený názov výsledku

cid

string

Identifikátor Google (CID) záznamu o zariadení

reviews

integer

Počet recenzií

rating

float

Priemerné hodnotenie z 5

website

string

Webová stránka zariadenia

type

string

Kategória zariadenia (napr.: reštaurácia)

address

string

Poštová adresa

status_label

string

Stav otvorenia (napr.: Otvorené, Zatvorené)

status_detail

string

Podrobnosti o stave (napr. pracovný čas)

comment

string

Zobrazený komentár / úryvok

images

array

Zoznam obrázkov v zázname

Žiadosť
Úspešná reakcia
Chybová odpoveď

Status: 200 OK
{
    "status": "success",
    "request_ms": 41,
    "count": 1,
    "data": [
        {
            "id": "SERP_ID",
            "status": "done",
            "keyword": "example keyword",
            "device": "desktop",
            "location": "fr",
            "language": "fr",
            "depth": 1,
            "geolocation": false,
            "priority": 1,
            "callback_url": "",
            "cost": "0.00002",
            "created_at": "2025-09-10T12:32:56Z",
            "scraped_at": "2025-09-10T12:33:02Z",
            "duration_ms": 5403,
            "serp_info": {
                "result_count": 1500000000
            },
            "results": [
                {
                    "type": "people_also_ask",
                    "items": [
                        {
                            "rank_type": 1,
                            "rank_serp": 4,
                            "page": 1,
                            "pixel": 806,
                            "domain": "guides.lib.uh.edu",
                            "url": "https://guides.lib.uh.edu/c.php?g\\x3d1249281",
                            "title": "What is a keyword example?",
                            "description": ""
                        },
                        {
                            "rank_type": 2,
                            "rank_serp": 5,
                            "page": 1,
                            "pixel": 858,
                            "domain": "toolsqa.com",
                            "url": "https://toolsqa.com/cucumber/data-driven-testing-using-examples-keyword/",
                            "title": "What is the example keyword used for?",
                            "description": ""
                        },
                        {
                            "rank_type": 3,
                            "rank_serp": 6,
                            "page": 1,
                            "pixel": 911,
                            "domain": "www.editage.com",
                            "url": "https://www.editage.com/insights/how-to-create-keywords-for-a-research-paper",
                            "title": "How do you write keywords examples?",
                            "description": ""
                        },
                        {
                            "rank_type": 4,
                            "rank_serp": 7,
                            "page": 1,
                            "pixel": 964,
                            "domain": "libguides.lvc.edu",
                            "url": "https://libguides.lvc.edu/c.php?g\\x3d1152118\\x26ampp\\x3d8409030",
                            "title": "What is an example of a keyword search?",
                            "description": ""
                        }
                    ]
                },
                {
                    "type": "videos",
                    "items": [
                        {
                            "rank_type": 1,
                            "rank_serp": 1,
                            "page": 1,
                            "pixel": 223,
                            "domain": "www.youtube.com",
                            "url": "https://www.youtube.com/watch?v=H-B5oFJjL8I",
                            "title": "What are Keywords and How to Choose Them? 1.1. SEO ...",
                            "description": ""
                        },
                        {
                            "rank_type": 2,
                            "rank_serp": 2,
                            "page": 1,
                            "pixel": 374,
                            "domain": "www.youtube.com",
                            "url": "https://www.youtube.com/watch?v=TTlEVVB75wo&pp=2AEAkAIB",
                            "title": "What Are Keywords? Everything You Need To Know (and more)",
                            "description": ""
                        },
                        {
                            "rank_type": 3,
                            "rank_serp": 3,
                            "page": 1,
                            "pixel": 526,
                            "domain": "www.youtube.com",
                            "url": "https://www.youtube.com/watch?v=OMJQPqG2Uas",
                            "title": "Keyword Research Tutorial: From Start to Finish",
                            "description": ""
                        }
                    ]
                },
                {
                    "type": "organic",
                    "items": [
                        {
                            "rank_type": 1,
                            "rank_serp": 8,
                            "page": 1,
                            "pixel": 1077,
                            "domain": "www.seoquantum.com",
                            "url": "https://www.seoquantum.com/en/blog/6-types-keywords-organic-seo",
                            "title": "The 6 Types of Keywords in Organic SEO",
                            "description": "2 mars 2024 — I will introduce you to 6 types of keywords that you absolutely need to know. We will start with the most common ones such as long-tail keywords and then move ..."
                        },
                        {
                            "rank_type": 2,
                            "rank_serp": 9,
                            "page": 1,
                            "pixel": 1223,
                            "domain": "storychief.io",
                            "url": "https://storychief.io/blog/seo-keyword-research-examples",
                            "title": "10 Clever SEO Keyword Research Examples",
                            "description": "Let's say you run a food blog. Some potential SEO keywords could be: quick weeknight dinners easy dinner recipes 30 minute meals one pot dinners"
                        },
                        {
                            "rank_type": 3,
                            "rank_serp": 10,
                            "page": 1,
                            "pixel": 1369,
                            "domain": "www.indeed.com",
                            "url": "https://www.indeed.com/career-advice/career-development/types-of-keywords",
                            "title": "19 Types of Keywords",
                            "description": "6 juin 2025 — 19 types of keywords and how to use them for marketing · 1. Market segment keywords · 2. Customer-defining keywords · 3. Product-defining ..."
                        },
                        {
                            "rank_type": 4,
                            "rank_serp": 11,
                            "page": 1,
                            "pixel": 1515,
                            "domain": "www.usg.edu",
                            "url": "https://www.usg.edu/galileo/skills/unit04/primer04_07.phtml",
                            "title": "Keyword Search",
                            "description": "In this case, the phrase alternative fuels and automobiles are the significant keywords."
                        },
                        {
                            "rank_type": 5,
                            "rank_serp": 12,
                            "page": 1,
                            "pixel": 1639,
                            "domain": "guides.lib.uh.edu",
                            "url": "https://guides.lib.uh.edu/c.php?g=1249281",
                            "title": "What are keywords and why are they important? - Guides",
                            "description": "You probably used the title of the film and the word “showtimes” as your keywords to bring up the results you needed. Keywords in academic research are similar."
                        },
                        {
                            "rank_type": 6,
                            "rank_serp": 13,
                            "page": 1,
                            "pixel": 1785,
                            "domain": "www.tactee.fr",
                            "url": "https://www.tactee.fr/seo/strategie-seo/keyword-seo/",
                            "title": "Qu'est ce qu'un keyword SEO ? [Définition & conseil]",
                            "description": "13 juil. 2024 — Commerciale : l'utilisateur compare des produits ou des services, par exemple « meilleur smartphone 2024 ». Identifier l'intention de recherche ..."
                        },
                        {
                            "rank_type": 7,
                            "rank_serp": 14,
                            "page": 1,
                            "pixel": 1931,
                            "domain": "backlinko.com",
                            "url": "https://backlinko.com/types-of-keywords",
                            "title": "10 Types of Keywords with Examples (+ How to Find Them)",
                            "description": "15 mai 2025 — 10 Types of Keywords with Examples (+ How to Find Them) · 1. Seed Keywords · 2. Informational Keywords · 3. Commercial Keywords · 4."
                        },
                        {
                            "rank_type": 8,
                            "rank_serp": 15,
                            "page": 1,
                            "pixel": 2077,
                            "domain": "learn.microsoft.com",
                            "url": "https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/",
                            "title": "C# Keywords and contextual keywords - C# reference",
                            "description": "17 avr. 2025 — For example, @if is a valid identifier, but if isn't because if is a keyword. The first table in this article lists keywords that are ..."
                        }
                    ]
                },
                {
                    "type": "images",
                    "items": [
                        {
                            "rank_type": 1,
                            "rank_serp": 16,
                            "page": 1,
                            "pixel": 2311,
                            "domain": "searchfacts.com",
                            "url": "https://searchfacts.com/what-are-keywords-in-seo/",
                            "title": "",
                            "description": ""
                        },
                        {
                            "rank_type": 2,
                            "rank_serp": 17,
                            "page": 1,
                            "pixel": 2311,
                            "domain": "backlinko.com",
                            "url": "https://backlinko.com/hub/seo/seo-keywords",
                            "title": "",
                            "description": ""
                        },
                        {
                            "rank_type": 3,
                            "rank_serp": 18,
                            "page": 1,
                            "pixel": 2311,
                            "domain": "ahrefs.com",
                            "url": "https://ahrefs.com/blog/what-are-keywords/",
                            "title": "",
                            "description": ""
                        }
                    ]
                }
            ]
        }
    ]
}
{

    "status": "success",

    "request_ms": 41,

    "count": 1,

    "data": [

        {

            "id": "SERP_ID",

            "status": "done",

            "keyword": "example keyword",

            "device": "desktop",

            "location": "fr",

            "language": "fr",

            "depth": 1,

            "geolocation": false,

            "priority": 1,

            "callback_url": "",

            "cost": "0.00002",

            "created_at": "2025-09-10T12:32:56Z",

            "scraped_at": "2025-09-10T12:33:02Z",

            "duration_ms": 5403,

            "serp_info": {

                "result_count": 1500000000

            },

            "results": [

                {

                    "type": "people_also_ask",

                    "items": [

                        {

                            "rank_type": 1,

                            "rank_serp": 4,

                            "page": 1,

                            "pixel": 806,

                            "domain": "guides.lib.uh.edu",

                            "url": "https://guides.lib.uh.edu/c.php?g\\x3d1249281",

                            "title": "What is a keyword example?",

                            "description": ""

                        },

                        {

                            "rank_type": 2,

                            "rank_serp": 5,

                            "page": 1,

                            "pixel": 858,

                            "domain": "toolsqa.com",

                            "url": "https://toolsqa.com/cucumber/data-driven-testing-using-examples-keyword/",

                            "title": "What is the example keyword used for?",

                            "description": ""

                        },

                        {

                            "rank_type": 3,

                            "rank_serp": 6,

                            "page": 1,

                            "pixel": 911,

                            "domain": "www.editage.com",

                            "url": "https://www.editage.com/insights/how-to-create-keywords-for-a-research-paper",

                            "title": "How do you write keywords examples?",

                            "description": ""

                        },

                        {

                            "rank_type": 4,

                            "rank_serp": 7,

                            "page": 1,

                            "pixel": 964,

                            "domain": "libguides.lvc.edu",

                            "url": "https://libguides.lvc.edu/c.php?g\\x3d1152118\\x26ampp\\x3d8409030",

                            "title": "What is an example of a keyword search?",

                            "description": ""

                        }

                    ]

                },

                {

                    "type": "videos",

                    "items": [

                        {

                            "rank_type": 1,

                            "rank_serp": 1,

                            "page": 1,

                            "pixel": 223,

                            "domain": "www.youtube.com",

                            "url": "https://www.youtube.com/watch?v=H-B5oFJjL8I",

                            "title": "What are Keywords and How to Choose Them? 1.1. SEO ...",

                            "description": ""

                        },

                        {

                            "rank_type": 2,

                            "rank_serp": 2,

                            "page": 1,

                            "pixel": 374,

                            "domain": "www.youtube.com",

                            "url": "https://www.youtube.com/watch?v=TTlEVVB75wo&pp=2AEAkAIB",

                            "title": "What Are Keywords? Everything You Need To Know (and more)",

                            "description": ""

                        },

                        {

                            "rank_type": 3,

                            "rank_serp": 3,

                            "page": 1,

                            "pixel": 526,

                            "domain": "www.youtube.com",

                            "url": "https://www.youtube.com/watch?v=OMJQPqG2Uas",

                            "title": "Keyword Research Tutorial: From Start to Finish",

                            "description": ""

                        }

                    ]

                },

                {

                    "type": "organic",

                    "items": [

                        {

                            "rank_type": 1,

                            "rank_serp": 8,

                            "page": 1,

                            "pixel": 1077,

                            "domain": "www.seoquantum.com",

                            "url": "https://www.seoquantum.com/en/blog/6-types-keywords-organic-seo",

                            "title": "The 6 Types of Keywords in Organic SEO",

                            "description": "2 mars 2024 — I will introduce you to 6 types of keywords that you absolutely need to know. We will start with the most common ones such as long-tail keywords and then move ..."

                        },

                        {

                            "rank_type": 2,

                            "rank_serp": 9,

                            "page": 1,

                            "pixel": 1223,

                            "domain": "storychief.io",

                            "url": "https://storychief.io/blog/seo-keyword-research-examples",

                            "title": "10 Clever SEO Keyword Research Examples",

                            "description": "Let's say you run a food blog. Some potential SEO keywords could be: quick weeknight dinners easy dinner recipes 30 minute meals one pot dinners"

                        },

                        {

                            "rank_type": 3,

                            "rank_serp": 10,

                            "page": 1,

                            "pixel": 1369,

                            "domain": "www.indeed.com",

                            "url": "https://www.indeed.com/career-advice/career-development/types-of-keywords",

                            "title": "19 Types of Keywords",

                            "description": "6 juin 2025 — 19 types of keywords and how to use them for marketing · 1. Market segment keywords · 2. Customer-defining keywords · 3. Product-defining ..."

                        },

                        {

                            "rank_type": 4,

                            "rank_serp": 11,

                            "page": 1,

                            "pixel": 1515,

                            "domain": "www.usg.edu",

                            "url": "https://www.usg.edu/galileo/skills/unit04/primer04_07.phtml",

                            "title": "Keyword Search",

                            "description": "In this case, the phrase alternative fuels and automobiles are the significant keywords."

                        },

                        {

                            "rank_type": 5,

                            "rank_serp": 12,

                            "page": 1,

                            "pixel": 1639,

                            "domain": "guides.lib.uh.edu",

                            "url": "https://guides.lib.uh.edu/c.php?g=1249281",

                            "title": "What are keywords and why are they important? - Guides",

                            "description": "You probably used the title of the film and the word “showtimes” as your keywords to bring up the results you needed. Keywords in academic research are similar."

                        },

                        {

                            "rank_type": 6,

                            "rank_serp": 13,

                            "page": 1,

                            "pixel": 1785,

                            "domain": "www.tactee.fr",

                            "url": "https://www.tactee.fr/seo/strategie-seo/keyword-seo/",

                            "title": "Qu'est ce qu'un keyword SEO ? [Définition & conseil]",

                            "description": "13 juil. 2024 — Commerciale : l'utilisateur compare des produits ou des services, par exemple « meilleur smartphone 2024 ». Identifier l'intention de recherche ..."

                        },

                        {

                            "rank_type": 7,

                            "rank_serp": 14,

                            "page": 1,

                            "pixel": 1931,

                            "domain": "backlinko.com",

                            "url": "https://backlinko.com/types-of-keywords",

                            "title": "10 Types of Keywords with Examples (+ How to Find Them)",

                            "description": "15 mai 2025 — 10 Types of Keywords with Examples (+ How to Find Them) · 1. Seed Keywords · 2. Informational Keywords · 3. Commercial Keywords · 4."

                        },

                        {

                            "rank_type": 8,

                            "rank_serp": 15,

                            "page": 1,

                            "pixel": 2077,

                            "domain": "learn.microsoft.com",

                            "url": "https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/",

                            "title": "C# Keywords and contextual keywords - C# reference",

                            "description": "17 avr. 2025 — For example, @if is a valid identifier, but if isn't because if is a keyword. The first table in this article lists keywords that are ..."

                        }

                    ]

                },

                {

                    "type": "images",

                    "items": [

                        {

                            "rank_type": 1,

                            "rank_serp": 16,

                            "page": 1,

                            "pixel": 2311,

                            "domain": "searchfacts.com",

                            "url": "https://searchfacts.com/what-are-keywords-in-seo/",

                            "title": "",

                            "description": ""

                        },

                        {

                            "rank_type": 2,

                            "rank_serp": 17,

                            "page": 1,

                            "pixel": 2311,

                            "domain": "backlinko.com",

                            "url": "https://backlinko.com/hub/seo/seo-keywords",

                            "title": "",

                            "description": ""

                        },

                        {

                            "rank_type": 3,

                            "rank_serp": 18,

                            "page": 1,

                            "pixel": 2311,

                            "domain": "ahrefs.com",

                            "url": "https://ahrefs.com/blog/what-are-keywords/",

                            "title": "",

                            "description": ""

                        }

                    ]

                }

            ]

        }

    ]

}

Status: 400 Bad Request
{
    "error": "InvalidParameter",
    "message": "DESCRIPTION_OF_ERROR",
    "code": 400
}
{

    "error": "InvalidParameter",

    "message": "DESCRIPTION_OF_ERROR",

    "code": 400

}

Obnovenie SERP prostredníctvom spätnej adresy URL

Výsledok SERP môžete získať priamo na adrese URL, ktorú nám poskytnete pri vytváraní dotazu. Stačí načítať kľúč HMAC prepojený s použitým kľúčom API.

Kód

                                        PHP
Python
Javascript
Ruby
Java
C#
GO

                                // 1) Read the raw body (JSON)

$raw = file_get_contents('php://input');

// 2) Retrieve the headers

$headers = function_exists('getallheaders') ? getallheaders() : [];

$signature = $headers['X-Signature'] ?? '';

// 3) (Optional) Verify the HMAC signature

$sharedSecret = 'HMAC_KEY';

$expected = hash_hmac('sha256', $raw, $sharedSecret);

if (!hash_equals($expected, $signature)) {

    http_response_code(401);

    header('Content-Type: text/plain; charset=utf-8');

    echo 'Invalid signature';

    exit;

}

// 4) Decode the JSON

$data = json_decode($raw, true);

if (json_last_error() !== JSON_ERROR_NONE) {

    http_response_code(400);

    header('Content-Type: text/plain; charset=utf-8');

    echo 'Invalid JSON';

    exit;

}

// 5) Process the data

// $data contains what you sent in the $payload from the client side.

// For example : $data['id'], $data['results'], etc.

// 6) Respond in JSON (optional, we log these responses for tracking purposes)

http_response_code(200);

header('Content-Type: application/json; charset=utf-8');

echo json_encode([

    'status' => 'ok',

    'received_at' => gmdate('c'),

    'echo' => $data['id'] ?? null

]);

                                        PHP
Python
Javascript
Ruby
Java
C#
GO

                                from flask import Flask, request, jsonify, make_response

import hmac

import hashlib

import json

from datetime import datetime, timezone

app = Flask(__name__)

SHARED_SECRET = b"HMAC_KEY"  # shared secret key

@app.route("/callback", methods=["POST"])

def callback():

    # 1) Read the raw body (JSON)

    raw = request.get_data()

    # 2) Retrieve the headers

    signature = request.headers.get("X-Signature", "")

    # 3) (Optional) Verify the HMAC signature

    expected = hmac.new(SHARED_SECRET, raw, hashlib.sha256).hexdigest()

    if not hmac.compare_digest(expected, signature):

        return make_response("Invalid signature", 401, {"Content-Type": "text/plain; charset=utf-8"})

    # 4) Decode the JSON

    try:

        data = json.loads(raw.decode("utf-8"))

    except json.JSONDecodeError:

        return make_response("Invalid JSON", 400, {"Content-Type": "text/plain; charset=utf-8"})

    # 5) Process the data

    # data contains what the client sent in the payload

    # For example: data["id"], data["results"], etc.

    # 6) Respond in JSON (optional, we log these responses for tracking purposes)

    response = {

        "status": "ok",

        "received_at": datetime.now(timezone.utc).isoformat(),

        "echo": data.get("id")

    }

    return jsonify(response), 200

if __name__ == "__main__":

    app.run(host="0.0.0.0", port=5000)

                                        PHP
Python
Javascript
Ruby
Java
C#
GO

                                const express = require("express");

const crypto = require("crypto");

const app = express();

const PORT = 5000;

const SHARED_SECRET = "HMAC_KEY";

// Middleware to parse JSON and keep raw body for HMAC verification

app.use(express.json({

  verify: (req, res, buf) => {

    req.rawBody = buf.toString(); // Save raw body for signature check

  }

}));

app.post("/callback", (req, res) => {

  // 1) Read the raw body (JSON)

  const raw = req.rawBody;

  // 2) Retrieve the headers

  const signature = req.get("X-Signature") || "";

  // 3) (Optional) Verify the HMAC signature

  const expected = crypto

    .createHmac("sha256", SHARED_SECRET)

    .update(raw)

    .digest("hex");

  // Use timing-safe comparison to avoid timing attacks

  if (!crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature))) {

    return res.status(401).type("text").send("Invalid signature");

  }

  // 4) Decode the JSON (Express already did it in req.body)

  let data;

  try {

    data = req.body;

  } catch (err) {

    return res.status(400).type("text").send("Invalid JSON");

  }

  // 5) Process the data

  // data contains what the client sent in the payload

  // For example: data.id, data.results, etc.

  // 6) Respond in JSON (optional, we log these responses for tracking purposes)

  res.status(200).json({

    status: "ok",

    received_at: new Date().toISOString(),

    echo: data.id || null

  });

});

app.listen(PORT, () => {

  console.log(`Server running

                                        PHP
Python
Javascript
Ruby
Java
C#
GO

                                require 'sinatra'

require 'json'

require 'openssl'

require 'rack/utils'

require 'time'

post '/callback' do

  # 1) Read the raw body (JSON)

  raw = request.body.read

  # 2) Retrieve the headers

  signature = request.env['HTTP_X_SIGNATURE'] || ''

  # 3) (Optional) Verify the HMAC signature

  shared_secret = 'HMAC_KEY'

  expected = OpenSSL::HMAC.hexdigest('SHA256', shared_secret, raw)

  unless Rack::Utils.secure_compare(expected, signature)

    halt 401, { 'Content-Type' => 'text/plain' }, 'Invalid signature'

  end

  # 4) Decode the JSON

  begin

    data = JSON.parse(raw)

  rescue JSON::ParserError

    halt 400, { 'Content-Type' => 'text/plain' }, 'Invalid JSON'

  end

  # 5) Process the data

  # data contient ce que le client a envoyé dans $payload

  # Ex : data["id"], data["results"], etc.

  # 6) Respond in JSON (optional)

  content_type :json

  status 200

  {

    status: 'ok',

    received_at: Time.now.utc.iso8601,

    echo: data['id']

  }.to_json

end

                                        PHP
Python
Javascript
Ruby
Java
C#
GO

                                import org.springframework.boot.SpringApplication;

import org.springframework.boot.autoconfigure.SpringBootApplication;

import org.springframework.http.HttpHeaders;

import org.springframework.http.HttpStatus;

import org.springframework.http.MediaType;

import org.springframework.http.ResponseEntity;

import org.springframework.util.DigestUtils;

import org.springframework.web.bind.annotation;

import javax.crypto.Mac;

import javax.crypto.spec.SecretKeySpec;

import java.nio.charset.StandardCharsets;

import java.time.Instant;

import java.util.HashMap;

import java.util.Map;

@SpringBootApplication

@RestController

public class CallbackApplication {

    private static final String SHARED_SECRET = "HMAC_KEY";

    public static void main(String[] args) {

        SpringApplication.run(CallbackApplication.class, args);

    }

    @PostMapping(value = "/callback", consumes = MediaType.APPLICATION_JSON_VALUE)

    public ResponseEntity handleCallback(@RequestBody String rawBody,

                                            @RequestHeader(value = "X-Signature", required = false) String signature) {

        try {

            // 1) Read the raw body (JSON)

            String raw = rawBody;

            // 2) Retrieve the headers

            String providedSignature = (signature != null) ? signature : "";

            // 3) (Optional) Verify the HMAC signature

            String expected = hmacSha256(raw, SHARED_SECRET);

            if (!secureCompare(expected, providedSignature)) {

                return ResponseEntity.status(HttpStatus.UNAUTHORIZED)

                        .contentType(MediaType.TEXT_PLAIN)

                        .body("Invalid signature");

            }

            // 4) Decode the JSON

            Map data;

            try {

                data = new com.fasterxml.jackson.databind.ObjectMapper().readValue(raw, Map.class);

            } catch (Exception e) {

                return ResponseEntity.status(HttpStatus.BAD_REQUEST)

                        .contentType(MediaType.TEXT_PLAIN)

                        .body("Invalid JSON");

            }

            // 5) Process the data

            // data contains what the client sent in the payload

            // For example: data.get("id"), data.get("results"), etc.

            // 6) Respond in JSON (optional, we log these responses for tracking purposes)

            Map response = new HashMap<>();

            response.put("status", "ok");

            response.put("received_at", Instant.now().toString());

            response.put("echo", data.get("id"));

            return ResponseEntity.ok()

                    .contentType(MediaType.APPLICATION_JSON)

                    .body(response);

        } catch (Exception e) {

            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)

                    .contentType(MediaType.TEXT_PLAIN)

                    .body("Server error");

        }

    }

    // Helper method: compute HMAC SHA-256

    private String hmacSha256(String data, String secret) throws Exception {

        Mac sha256_HMAC = Mac.getInstance("HmacSHA256");

        SecretKeySpec secretKey = new SecretKeySpec(secret.getBytes(StandardCharsets.UTF_8), "HmacSHA256");

        sha256_HMAC.init(secretKey);

        byte[] hash = sha256_HMAC.doFinal(data.getBytes(StandardCharsets.UTF_8));

        return bytesToHex(hash);

    }

    // Helper method: secure string comparison (to avoid timing attacks)

    private boolean secureCompare(String a, String b) {

        if (a == null || b == null || a.length() != b.length()) {

            return false;

        }

        int result = 0;

        for (int i = 0; i < a.length(); i++) {

            result |= a.charAt(i) ^ b.charAt(i);

        }

        return result == 0;

    }

    // Helper method: convert bytes to hex string

    private String bytesToHex(byte[] bytes) {

        StringBuilder hexString = new StringBuilder(2  bytes.length);

        for (byte b : bytes) {

            String hex = Integer.toHexString(0xff & b);

            if (hex.length() == 1) hexString.append('0');

            hexString.append(hex);

        }

        return hexString.toString();

    }

}

                                        PHP
Python
Javascript
Ruby
Java
C#
GO

                                using System.Security.Cryptography;

using System.Text;

using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

const string SHARED_SECRET = "HMAC_KEY";

app.MapPost("/callback", async (HttpRequest request, HttpResponse response) =>

{

    // 1) Read the raw body (JSON)

    using var reader = new StreamReader(request.Body);

    var raw = await reader.ReadToEndAsync();

    // 2) Retrieve the headers

    var signature = request.Headers["X-Signature"].FirstOrDefault() ?? "";

    // 3) (Optional) Verify the HMAC signature

    using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(SHARED_SECRET));

    var hash = hmac.ComputeHash(Encoding.UTF8.GetBytes(raw));

    var expected = Convert.ToHexString(hash).ToLowerInvariant();

    if (!CryptographicOperations.FixedTimeEquals(

            Encoding.UTF8.GetBytes(expected),

            Encoding.UTF8.GetBytes(signature)))

    {

        response.StatusCode = 401;

        response.ContentType = "text/plain; charset=utf-8";

        await response.WriteAsync("Invalid signature");

        return;

    }

    // 4) Decode the JSON

    Dictionary? data;

    try

    {

        data = JsonSerializer.Deserialize>(raw);

    }

    catch (JsonException)

    {

        response.StatusCode = 400;

        response.ContentType = "text/plain; charset=utf-8";

        await response.WriteAsync("Invalid JSON");

        return;

    }

    // 5) Process the data

    // data contains what the client sent in the payload

    // For example: data["id"], data["results"], etc.

    // 6) Respond in JSON (optional, we log these responses for tracking purposes)

    var jsonResponse = new

    {

        status = "ok",

        received_at = DateTime.UtcNow.ToString("o"), // ISO 8601

        echo = data != null && data.ContainsKey("id") ? data["id"] : null

    };

    response.StatusCode = 200;

    response.ContentType = "application/json; charset=utf-8";

    await response.WriteAsync(JsonSerializer.Serialize(jsonResponse));

});

app.Run();

                                        PHP
Python
Javascript
Ruby
Java
C#
GO

                                package main

import (

	"crypto/hmac"

	"crypto/sha256"

	"encoding/hex"

	"encoding/json"

	"io"

	"net/http"

	"time"

)

const sharedSecret = "HMAC_KEY"

func callbackHandler(w http.ResponseWriter, r http.Request) {

	// 1) Read the raw body (JSON)

	raw, err := io.ReadAll(r.Body)

	if err != nil {

		http.Error(w, "Unable to read body", http.StatusBadRequest)

		return

	}

	defer r.Body.Close()

	// 2) Retrieve the headers

	signature := r.Header.Get("X-Signature")

	// 3) (Optional) Verify the HMAC signature

	mac := hmac.New(sha256.New, []byte(sharedSecret))

	mac.Write(raw)

	expectedBytes := mac.Sum(nil)

	expected := hex.EncodeToString(expectedBytes)

	// Constant-time comparison

	if !hmac.Equal([]byte(expected), []byte(signature)) {

		w.Header().Set("Content-Type", "text/plain; charset=utf-8")

		http.Error(w, "Invalid signature", http.StatusUnauthorized)

		return

	}

	// 4) Decode the JSON

	var data map[string]any

	if err := json.Unmarshal(raw, &data); err != nil {

		w.Header().Set("Content-Type", "text/plain; charset=utf-8")

		http.Error(w, "Invalid JSON", http.StatusBadRequest)

		return

	}

	// 5) Process the data

	// data contains what the client sent in the payload

	// For example: data["id"], data["results"], etc.

	// 6) Respond in JSON (optional, we log these responses for tracking purposes)

	resp := map[string]any{

		"status":      "ok",

		"received_at": time.Now().UTC().Format(time.RFC3339), // ISO 8601

		"echo":        data["id"],

	}

	w.Header().Set("Content-Type", "application/json; charset=utf-8")

	w.WriteHeader(http.StatusOK)

	_ = json.NewEncoder(w).Encode(resp)

}

func main() {

	http.HandleFunc("/callback", callbackHandler)

	http.ListenAndServe(":8080", nil)

}

Súčasný stav spracovania SERP

Zobrazenie počtu stránok SERP podľa ich stavu:
Dokončené a výsledky načítané používateľom (status=done, fetched=true)
Ukončené a výsledky neboli načítané používateľom (status=done, fetched=false)
V procese (status=processing)
Čakanie (status=pending)

get

https://api.semscraper.com/v1/serp/status

Povolenia : Bearer {api_key}

Žiadosť
Úspešná reakcia

Status: 200 OK
{
    "status": "success",
    "request_ms": 54,
    "count": 4,
    "data": [
        {
            "status": "done",
            "fetched": true,
            "count": 5
        },
        {
            "status": "done",
            "fetched": false,
            "count": 1000
        },
        {
            "status": "processing",
            "count": 0
        },
        {
            "status": "pending",
            "count": 0
        }
    ]
}
{

    "status": "success",

    "request_ms": 54,

    "count": 4,

    "data": [

        {

            "status": "done",

            "fetched": true,

            "count": 5

        },

        {

            "status": "done",

            "fetched": false,

            "count": 1000

        },

        {

            "status": "processing",

            "count": 0

        },

        {

            "status": "pending",

            "count": 0

        }

    ]

}

Fakturácia

Vrátenie zostávajúceho úveru

get

https://api.semscraper.com/v1/billing/credit

Povolenia : Bearer {api_key}

Žiadosť
Úspešná reakcia

Status: 200 OK
{
    "status": "success",
    "request_ms": 21,
    "count": 1,
    "data": [
        {
            "balance": 100.50
        }
    ]
}
{

    "status": "success",

    "request_ms": 21,

    "count": 1,

    "data": [

        {

            "balance": 100.50

        }

    ]

}

Dostupné spôsoby platby

get

https://api.semscraper.com/v1/billing/payment_methods

Povolenia : Bearer {api_key}

Žiadosť
Úspešná reakcia

Status: 200 OK
{
    "status": "success",
    "request_ms": 43,
    "count": 3,
    "data": [
        {
            "id": 1,
            "name": "Perso",
            "num": "-4242",
            "expiration": "1226",
            "type": "Visa",
            "master": false
        },
        {
            "id": 30,
            "name": "Pro",
            "num": "-4444",
            "expiration": "1227",
            "type": "Mastercard",
            "master": true
        }
    ]
}
{

    "status": "success",

    "request_ms": 43,

    "count": 3,

    "data": [

        {

            "id": 1,

            "name": "Perso",

            "num": "-4242",

            "expiration": "1226",

            "type": "Visa",

            "master": false

        },

        {

            "id": 30,

            "name": "Pro",

            "num": "-4444",

            "expiration": "1227",

            "type": "Mastercard",

            "master": true

        }

    ]

}