Change language settings to use Topvisor in your preferred language. You can select and set a preferred language later in the Account settings. Change language settings to use Topvisor in your preferred language. ru Русский Apply

Field objects and types

API services are applicable to different data models.
Each model has a unique set of parameters.
For the list of data models and fields, view API Services.

Field types

  • int - integer
  • float - float
  • string - string
  • date - string in format: "yyyy-mm-dd"
  • array - array
  • object - object/associative array
  • set - one or several values (comma-separated) from the available values list
  • enum - one value from the available values list
  • boolean - 0 or 1
  • array of int - array of integers
  • array of float - array of float values
  • array of string - array of strings
  • array of date - array of date values
  • array of enum - array of enum values

Common fields description

Field name Title Description
id Object ID ID of object you're working with.
project_id Project ID Project ID is used to select a project.
searcher_key SE

Search engine key:

  • 0 - Yandex
  • 1 - Google
  • 2 - go.Mail
  • 4 - YouTube
  • 5 - Bing
  • 6 - Yahoo
  • 7 - Seznam
  • 8 - AppStore
  • 9 - GooglePlay
  • 20 - Yandex.com
  • 21 - Yandex.com.tr

region_key Region key

Region key (city, town, country or any other region) is used to select a region in Topvisor.

Each region key is unique in Topvisor.

region_lang Region language Region language defines a search results basic language for rank tracking and checking operations.
region_index Region index

Region index defines a set of unique parameters: searcher_key + region_key + region_lang.

You can find region index in the project region settings or by using a get/positions_2/regionIndex method.