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 list of tasks with status (tasks.getList)

The tasks.getList method allows getting a list of required tasks with status.

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.getList
params Object with parameters object no
page Response page number int yes "page": 2
pageSize Answer size per page (from 100 to 1000) int yes "pageSize": 1000

Response parameters
Parameter Description
id Identifiers of the current request
result Contains the answer
task_id
Crawling identifier
se_id Search engine identifier
country_id Country identifier
lang_id Language identifier
region_id Region or city identifier
device_type_id Device type identifier
progress Task execution progress percent
keywords_count Keywords quantity in the task
created_at Date and time, when the task was created
parsed_at Date and time, when the task was completed

Example
Request data:
{
  "id": 1,
  "method": "tasks.getList",
  "params": {
       "page": 1,
       "pageSize": 1000
    }
}
Response data:
{
    "id": "1",
    "result": [
        {
            "task_id": "2071484",
            "se_id": "1",
            "country_id": "23",
            "lang_id": "1",
            "region_id": "21176",
            "device_type_id": "1",
            "progress": "100%",
            "keywords_count": "3",
            "created_at": "2021-07-30 16:21:30",
            "parsed_at": "2021-07-30 16:25:45"
        },
        {
            "task_id": "2071492",
            "se_id": "1",
            "country_id": "23",
            "lang_id": "1",
            "region_id": "0",
            "device_type_id": "1",
            "progress": "100%",
            "keywords_count": "2",
            "created_at": "2021-07-30 16:54:54",
            "parsed_at": "2021-07-30 17:00:45"
        }
    ]
}

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