Manage columns 

     

Manage columns 

Column
    save changes
    • Recent columns list
    • Save
    • Save as new template
    • Rename
    • Delete
     Added columns Column settings Delete columns
    • No columns added
    Advanced options
    OK

    Select locations 

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

    Sign in

         

    Sign up now

         

    Recover password

         

    Recover password

         

    Recover password

    Forgot your password? Sign in
    No account? Sign up
    Sign up
    By pressing Sign up you accept Terms and Conditions and Privacy Policy
    Already have an account? Sign in
    A confirmation link has been sent to

    If you didn't receive a message, check a Spam folder or apply a ticket to Customer support
    Sign in
    Recover password
    Log in or sign up
    A confirmation link has been sent to

    If you didn't receive a message, check a Spam folder or apply a ticket to Customer support
    Sign in

    get/positions_2/summary_chart

    Method description

    Use the method to return metrics coordinates for a graph with the following axes: Date/Value.

    There are 3 available graphs:

    • Date/TOP segments (several values, one for every TOP segment)
    • Date/Visibility
    • Date/Average position

    Method parameters

    Parameter Type Description Default
    Mandatory
    project_id int project ID
    region_index int Region index
    dates array of date Custom dates of keyword ranking checks
    (dates is mandatory, if date1 or date2 are not specified)
    date1, date2 date The first and the last date of a period
    (date1 and date2 are mandatory, if dates isn't specified)
    Additional
    competitor_id array IDs of competitors added in the project settings.
    If not specified, competitors visibility and average position are returned.
    type_range enum(0, 1, 2, 3, 4, 5, 6, 7, 100)

    Period

    Available options:

    • 0 - entire period
    • 1 - updates only
    • 2 - period up to 31 dates
    • 3 - two dates
    • 4 - one date
    • 5 - last date of each month
    • 6 - dates in equal intervals
    • 7 - two last dates of rank checking
    • 100 - custom dates (use with the dates parameter only)
    		 2
    only_exists_first_date int boolean Add keywords with checks on all dates within a period 0
    show_tops int boolean Add TOPs data 0
    show_avg int boolean Add average position 0
    show_visibility int boolean Add visibility 0

    View in API explorer

    Returned data

    Parameter Type Description
    result (object)
    dates array Custom dates (X axis)
    seriesByProjectsId object Coordinates grouped by a project ID
    result.seriesByProjectsId.%projectId%
    tops object

    Number of keywords in TOPs

    Object properties:

    • {NN}_{NN} - TOP segments. By default, the following TOP segments are returned:
      • 1_3 - TOP3
      • 1_10 - TOP10
      • 11_30 - TOP11-30
      • 31_50 - TOP31-50
      • 51_100 - TOP51-100
      • 101_10000 - TOP100+
    • all - total sum in all TOPs
    avg array Average position for dates specified in dates
    visibility array Visibility for dates specified in dates

    FAQ