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

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

By using the website, you agree to our Privacy policy

Sign in Sign Up

Sending keywords to frequency parsing (SerpstatTaskProcedure.addKeywordListFreq)

SerpstatTaskProcedure.addKeywordListFreq — this method sends keywords to frequency parsing and returns a unique task key to be used for SerpstatTaskProcedure.getTaskResultFreq to get parsing results. Keywords must be transferred as an array.

Request parameters:

Parameter

Description

Type

Optional

Default value

Value Options

keywords

Keywords. Max amount  - 50 000

array

no

se id

Search base

string

yes

1

1 - google

2 - yandex

type Id

Device id type

int

yes

 1

1 - desktop

2 - mobile

region Id

Region or city id for Google or Yandex Region is indicated in the document

int

no

 

match

Type match id (Yandex only)

string

yes

exact

exactdoesn’t care about word order but does care about word form. Example: “!buy in instalments!”

extracares about both word form and order. Example: “[!buy!in instalments]”

phraseanything that contains these words in a different order or word form will do. Example: “to buy an elephant in instalments”

widewide match with the fixed word form. Example: “an elephant in instalments”

wide-fixed - wide match with the fixed word form. Example: “an elephant in instalments”

size

Number of results per page in response

int

yes

100

"size": {{page_size}}

min: 1, max: 1000

Response metrics:

Metrics

Description

Type

id

Query id which is used to process asynchronous queries. Matches value in a query

int

result

Contains the answer

array

task Id

Query id to get parsing results by  SerpstatTaskProcedure.getTaskResultFreq string

accepted

Total number of keywords set for parsing excluding blocked int

blocked

Array of blocked keywords. Limits aren’t charged. array

Keywords block

Some keywords will get to blocked array in the method’s response, because there’s no frequency checking for keywords containing the following search operators:

  • site:
  • related:
  • info:
  • cache:
  • OR 
  • url:
  • inurl:

Additional for Yandex

  • title:
  • rhost:
  • host:
  • domain:
  • mime:
  • lang:
  • date:
  • cat:

Keywords cleaning for special elements

Special elements are deleted from unblocked keywords. A list of prohibited special elements:

'  

*

+

-

@

~

!

&

|

(

)

:

.

;

Frequency issue block for search engine

Keywords may not pass the frequency checking for a search engine. The keywords’ subject that won’t pass checking.

for Google:

https://support.google.com/adspolicy/answer/6008942?hl=ru

for Yandex:

https://yandex.ru/support/direct/moderation/restricted-categories.html

If the keyword failed a search engine check, SerpstatTaskProcedure.getTaskResultFreq method will fill the status field for a keyword with value 4.

Limits:

This method corresponds to specific limits. You will find conditions and price details following this link.

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

Personal demonstration

Serpstat is all about saving time, and we want to save yours! One of our specialists will contact you and discuss options going forward.

These may include a personal demonstration, a trial period, comprehensive training articles & webinar recordings, and custom advice from a Serpstat specialist. It is our goal to make you feel comfortable while using 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

Спасибо, мы с вами свяжемся в ближайшее время

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