Dynamics page summary


Operation GET parameters POST parameters Response
Get dynamics page summary &oper=edit&module=mod_keywords
&func=history_summary
project_id, group_id, date1, date2, searcher, region_key {
visibility,
up_visibility,
avg,
up_avg,
count,
up_position,
stay_position,
down_position,
count3,
count10,
count30,
count50,
count100,
count10000,
up3,
up10,
up30,
up50,
up100,
up10000
}

Description of POST parameters:

  • project_id – project id;
  • group_id – id of keyword group ("-1" – all groups);
  • date1 – from the date (international format YYYY-MM-DD);
  • date2 – until the date (international formatт YYYY-MM-DD);
  • searcher – selected SE:
    • 0 - Yandex, location-based;
    • 1 - Google, location-based;
    • 2 - Mail
    • 3 - Sputnik
    • 4 - Youtube
    • 5 - Bing
    • 6 - Yahoo
    • -2 - Searchers comparison
  • region_key – location number (search results location code "-1", regions comparison "-2");

Response description:

  • visibility – visibility value;
  • up_visibility – visibility dynamics (up/down);
  • avgaverage-position value;
  • up_avg – average-position dynamics (up/down);
  • count – total number of keywords advanced/didn't change/dropped in rankings;
  • up_position – number of keywords advanced in rankings;
  • stay_position – number of keywords that didn't change in rankings;
  • down_position – number of keywords dropped in rankings;
  • count3/count10/count11-30/count31-50/count51-100/count100+ – number of keywords in TOP3/TOP10/TOP11-30/TOP31-50/TOP51-100/TOP100+;
  • up3/up10/up11-30/up31-50/up51-100/up100+ – keywords dynamics TOP3/TOP10/TOP11-30/TOP31-50/TOP51-100/TOP100+;

Get dynamics page summary of project id XXX (SE - Google, selected region - Chicago) from
25.07.2016 until 4.08.2016:

https://api.topvisor.ru/?api_key=Your_Key&oper=get&module=mod_keywords&func=history_summary
&post[project_id]=XXX&post[group_id]=-1&post[date1]=2016-07-25&post[date2]=2016-08-04&post[searcher]=1&post[region_key]=1000001