hasSearchVolume

Generates an approximate forecast of impressions for the specified keywords and regions, broken down by device type. Used when selecting keywords.

  1. Restrictions
  2. Request
  3. Response

Restrictions

Each advertiser can send a maximum of 20 requests every 60 seconds to the Reports service.

Request

Request structure in JSON format:

{
  "method": "hasSearchVolume",
  "params": { /* params */
    "SelectionCriteria": {  /* HasSearchVolumeSelectionCriteria */
      "Keywords": [(string), ... ], /* required */
      "RegionIds": [(long), ... ] /* required */
    }, /* required */
    "FieldNames": [( "Keyword" | "RegionIds" | "AllDevices" | "MobilePhones" | "Tablets" | "Desktops" ), ... ] /* required */
  } 
}

Parameters are described below.

ParameterTypeDescriptionRequired
Params structure (for JSON) / HasSearchVolumeRequest (for SOAP)
SelectionCriteriaHasSearchVolumeSelectionCriteria

The keywords and regions to get a forecast for.

Yes
FieldNamesarray of HasSearchVolumeFieldEnum

The names of parameters to get.

Yes
HasSearchVolumeSelectionCriteria structure
Keywordsarray of string

Keywords. From 1 to 10,000 items in the array. Duplicate strings are not allowed.

A keyword may contain operators.

The maximum length of a keyword is 4096 characters. The “!” operator before a negative keyword is not counted in the keyword length (the sequence “-!” counts as a single character).

Maximum of 7 words per keyword, not counting stop words and negative keywords. Each word can have up to 35 characters, not counting the minus sign before a negative keyword.

Yes
RegionIdsarray of long

IDs of regions where ad impressions are enabled or disabled.

The ID 0 specifies to display ads in all regions.

A minus sign before a region ID disables impressions in this region. For example, [1,-219] indicates to display for Moscow and the entire Moscow area, except Chernogolovka. Minus regions can't be used if 0 is set. The array must not consist of only minus regions.

To get the list of regions, use the Dictionaries.get method.
Yes

Response

Response structure in JSON format:

{
  "result": { /* result */
    "HasSearchVolumeResults": [{  /* HasSearchVolumeItem */
      "Keyword": (strng),
      "RegionIds": [(long), ... ],
      "AllDevices": ( YES | NO ),
      "MobilePhones": ( YES | NO ),
      "Tablets": ( YES | NO ),
      "Desktops": ( YES | NO )
    }, ... ],
  }
}

Parameters are described below.

ParameterTypeDescription
result structure (for JSON) / HasSearchVolumeResponse (for SOAP)
HasSearchVolumeResultsarray of HasSearchVolumeItemForecast of impressions.
HasSearchVolumeItem structure
KeywordstringThe keyword from the request.
RegionIdsarray of longRegion IDs from the request.
AllDevicesYesNoEnumWhether there are impressions.
MobilePhonesYesNoEnumWhether there are impressions on mobile phones.
TabletsYesNoEnumWhether there are impressions on tablets.
DesktopsYesNoEnumWhether there are impressions on desktop browsers.