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

Position check status within SVCS V4 (SerpstatTaskProcedure.getTaskStatus)

SerpstatTaskProcedure.getTaskStatus — this method helps to obtain a position's check status with “task_id by SerpstatTaskProcedure.addKeywordListFreq.

Request parameters:

Parameter

Description

Type

Optional

Default value

Value Options

task Id

Query id

string

no

-

352ab0be-b8a4-4966-8d16-f9137cb93c23

page

Ordinal number of result page

int

yes

1

50

pageSize

Number of results on a page

int

yes

100

1000

Response metrics:

Parameter

Description

Type

id

Query id used to process asynchronous queries

int

result

Object with results

json object

totalKeywords

Total number of keywords in a task flagged for position checking

int

progress

Task progress. Total keywords ratio in a task to the number of keywords with 2-4 status (percentage)

int

keywordsStatusCount

Array of statuses

json object

status

Position check statuses are following:

0 - keyword is in storage ready for parsing 

1 - keyword is sent for position check (in progress)

2 - position check completed successfully, data is in place

3 - error sending to the queue

4 - position check error. A keyword hasn’t passed search engine issue. Detailed key thematic range is described here for Google and Yandex.

json object

count

Number of keywords with stated above status int

Example PHP Python
Request data:

Response data:

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
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