Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free..
Sign in Sign Up

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

Getting a SERP Crawling results using the identifiers (tasks.getTaskResult)

The tasks.getTaskResult method allows getting a SERP Crawling result using the identifiers.

General request parameters and instructions for using Serpstat API

Request parameters
Parameter Description Type Optional Value options
id The identifier of a current request, can be set manually or automatically string no 1, test
method API method name string no tasks.getTaskResult
params Object with parameters object no
taskId Id number from SERP crawling — the same id, which you are using to get a result for SERP crawling (from methods: tasks.addTask или tasks.addKeywordList) int no 2071486
page In high-volume projects, it returns results separated into parts. The response contains the next_page parameter, which indicates the number of the next part of the result. int yes "page": 2

Response parameters
Parameter Description
id Identifiers of the current request
result Contains the answer
next_page The parameter is available in high-volume projects where results are separated into parts
task_meta Crawling identifiers settings:
se_id — search engine identifier;
* country_id — country identifier;
* region_id — region or city identifier;
device_type_id — device type identifier
tops The project’s keywords result array
keyword_id
ID number of a required keyword for getting a SERP
keyword
A keyword
keyword_data
Contains parameters
top
Tops array for the current keyword
url
URL of the webpage
domain
Domain name result
subdomain
A subdomain of a domain
snippet_length
The length of snippet
title
Title in a search result
title_length
The length of title
snippet
HTML view
breadcrumbs
“Bread crumbs”, if it is in the search result
spec_elements
Array with parameters of special elements
types
List of special elements shown in SERP (for example, video, carousel or map)
position
Position in the list
ads
Context advertisement:
 1 — search results at the top of the page;
 2 — search results on the right of the page (outdated view);
 3 — search results at the bottom of the page

PPC object parameters:
* domain — domain name result;
* position — position in the list;
* subdomain — subdomain of a domain;
* text — add text;
* title — title in the search result;
* url — URL of the webpage;
* top_features_content — array with parameters of special elements
right_spell
Rightly  spell of the keyword
results
Total number of results in SERP

Errors
Error Description
Task not found Task with such ID is not found
Not all keywords have been tracked. Progress x% Not all keywords have been processed. Progress in percents for the task.

Example
Request data:
{
    "id": "some_id" ,
    "method": "tasks.getTaskResult",
    "params": {
        "taskId": 2071486
    }
}
Response data:
{
    "id": "some_id",
    "result": {
        "task_meta": {
            "se_id": "1",
            "country_id": "23",
            "region_id": "0",
            "device_type_id": "1"
        },
        "tops": [
            {
                "keyword_id": "469901244",
                "keyword": "iphone 12",
                "keyword_data": {
                    "top": [
                        {
                            "url": "https://www.apple.com/iphone-12/",
                            "domain": "apple.com",
                            "subdomain": "www.apple.com",
                            "snippet_length": 138,
                            "title": "iPhone 12 and iPhone 12 mini - Apple",
                            "title_length": 36,
                            "snippet": Meet the new iPhone 12 and iPhone 12 mini. 5G speed. A14 Bionic. Super Retina XDR display. Ceramic Shield. And Night mode on every camera.,
                            "breadcrumbs": "https://www.apple.com › iphone-12",
                            "spec_elements": [
                                {
                                    "type": "snip_breadcrumbs",
                                    "anchor": null,
                                    "href": null,
                                    "content": "https://www.apple.com › iphone-12",
                                    "sort_number": 0
                                }
                            ],
                            "types": [
                                "snip_breadcrumbs"
                            ],
                            "position": 1
                        },
                        {
                            "url": "https://www.apple.com/iphone-12-pro/",
                            "domain": "apple.com",
                            "subdomain": "www.apple.com",
                            "snippet_length": 148,
                            "title": "iPhone 12 Pro Max - Apple",
                            "title_length": 25,
                            "snippet": iPhone 12 Pro and iPhone 12 Pro Max. 5G. A14 Bionic. Ceramic Shield. Pro camera system. LiDAR Scanner. Night mode portraits. Dolby Vision recording.,
                            "breadcrumbs": "https://www.apple.com › iphone-12-pro",
                            "spec_elements": [
                                {
                                    "type": "snip_breadcrumbs",
                                    "anchor": null,
                                    "href": null,
                                    "content": "https://www.apple.com › iphone-12-pro",
                                    "sort_number": 0
                                }
                            ],
                            "types": [
                                "snip_breadcrumbs"
                            ],
                            "position": 2
                        },

...

                    ],
                    "ads": {
                        "1": [
                            {
                                "title": "iPhone 12 - Apple Official Site",
                                "url": "https://www.apple.com/iphone-12/",
                                "domain": "apple.com",
                                "subdomain": "www.apple.com",
                                "text": "5G speed. Blast past fast. Buy now. Special AT&T offer available at apple.com. Night mode. A14 Bionic chip. Six colors. Super Retina XDR display. 5G. Ceramic Shield.",
                                "position": 1
                            },
                            {
                                "title": "Verizon: iPhone 12 Offer - Up To $700 Off w/ Trade In",
                                "url": "https://www.verizon.com/smartphones/apple-iphone-12/",
                                "domain": "verizon.com",
                                "subdomain": "www.verizon.com",
                                "text": "Up to $700 w/ select trade-in & select Unlimited. Plus up to $500 w/ port-in. Terms apply.",
                                "position": 2
                            }
                        ],
                        "2": [],
                        "3": []
                    },
                    "types": [
                        "top_stories",
                        "shopping_top",
                        "kn_graph_disambiguation",
                        "kn_graph_carousel_list",
                        "ads_top"
                    ],
                    "results": 82,
                    "right_spell": "",
                    "top_features_content": [
                        {
                            "Disambiguation": {
                                "HiddenName": {
                                    "text": "See results about"
                                }
                            }
                        },
                        {
                            "TopShop": {
                                "TopShopBlock": {
                                    "shop_content": [
                                        {
                                            "position": 1,
                                            "store_url": "https://www.verizon.com/smartphones/apple-iphone-12/?sku=sku4120364",
                                            "title": "Apple iPhone 12 128 GB in Blue with installment",
                                            "price": "$0.00",
                                            "store": "Verizon",
                                            "network": "n/a",
                                            "network_url": "n/a"
                                        },
                                        {
                                            "position": 2,
                                            "store_url": "https://www.verizon.com/smartphones/apple-iphone-12/?sku=sku4490077",
                                            "title": "Apple iPhone 12 128 GB in Purple with installment",
                                            "price": "$0.00",
                                            "store": "Verizon",
                                            "network": "n/a",
                                            "network_url": "n/a"
                                        },

...

                                    ]
                                }
                            }
                        },
                        {
                            "Disambiguation": {
                                "HiddenName": {
                                    "text": "See results about"
                                }
                            }
                        }
                    ]
                },
                "target_fields": "[]"
            }
        ]
    }
}

Share this article with your friends

Sign In Free Sign Up

You’ve reached your query limit.

Or email
Forgot password?
Or email
Optional
Back To Login

Don’t worry! Just fill in your email and we’ll send over your password.

Are you sure?

Awesome!

To complete your registration you need to enter your phone number

Back

We sent confirmation code to your phone number

Your phone Resend code Queries left

Something went wrong.

Contact our support team
Or confirm the registration using the Telegram bot Follow this link
Please pick the project to work on

Introducing Serpstat

Find out about the main features of the service in a convenient way for you!

Please send a request, and our specialist will offer you education options: a personal demonstration, a trial period, or materials for self-study and increasing expertise — everything for a comfortable start to work with Serpstat.

Name

Email

Phone

We are glad of your comment
I agree to Serpstat`s Privacy Policy.
Upgrade your plan

Upgrade your plan

Export is not available for your account. Please upgrade to Lite or higher to get access to the tool. Learn more

Sign Up Free

Thank you, we have saved your new mailing settings.

Invite
View Editing

E-mail
Message
Optional
E-mail
Message
Optional

You have run out of limits

You have reached the limit for the number of created projects. You cannot create new projects unless you increase the limits or delete existing projects.

I want more limits
Open support chat