Для начала работы с API SEOWORK необходимо обратиться в поддержку по почте help@seowork.ru или в чате на сайте. Для вас будет создан API токен для работы.

Для получения используется GET-запрос со следующими параметрами:

Категории

Формат запроса

GET https://seowork.ru/semantics/api/v4/dashboard/category


Например:

https://seowork.ru/semantics/api/v4/dashboard/category?token=...&project_id=123&date=2019-12-20&search_engine=yandex

Формат ответа:

{
"data": {
"items": [
{
"date": "2019-12-20",
"id": 2971,
"name": "без категории",
"position_avg": 29,
"ws1": 1354909,
"ws2": 15607,
"ws3": 15065,
"p_traf": 23.23,
"top3_count": 0,
"top5_count": 7,
"top10_count": 28,
"top100_count": 100,
"top3_prc": 0,
"top5_prc": 6.19,
"top10_prc": 24.78,
"top100_prc": 88.5,
"ws1_top10": 1,
"ws2_top10": 10,
"ws1_top10_prc": 0.52,
"ws2_top10_prc": 8.68,
"p_traf_prc": 1.49,
"worth": 0,
"worth_max": 70,
"worth_reserve": 70,
"worth_prc": 0
},
...
...
],
"count": 22,
"total": 22,
"limit": 100,
"page": 1
},
"version": 1,
"status": 200,
"error": 0,
"error_messages": []
}

Группы

Формат запроса:

GET https://seowork.ru/semantics/api/v4/dashboard/group


Например:

https://seowork.ru/semantics/api/v4/dashboard/group?token=...&project_id=123&date=2019-12-20&search_engine=yandex

Формат ответа:

{
"data": {
"items": [
{
"date": "2019-12-20",
"id": 2154,
"name": "уход за телом",
"position_avg": 20,
"ws1": 17358,
"ws2": 3265,
"ws3": 1495,
"p_traf": 23.54,
"top3_count": 12,
"top5_count": 30,
"top10_count": 99,
"top100_count": 247,
"top3_prc": 4.65,
"top5_prc": 11.63,
"top10_prc": 38.37,
"top100_prc": 95.74,
"ws1_top10": 90,
"ws2_top10": 82,
"ws1_top10_prc": 34.9,
"ws2_top10_prc": 31.88,
"p_traf_prc": 7.21,
"worth": 0,
"worth_max": 400,
"worth_reserve": 400,
"worth_prc": 0
},
...
...
],
"count": 50,
"total": 50,
"limit": 100,
"page": 1
},
"version": 1,
"status": 200,
"error": 0,
"error_messages": []
}

Выборки

Формат запроса:

GET https://seowork.ru/semantics/api/v4/dashboard/query_group

Например:

https://seowork.ru/semantics/api/v4/dashboard/query_group?token=...&project_id=123&date=2019-12-20

Формат ответа:

{
"data": {
"items": [
{
"date": "2019-12-20",
"id": 1204,
"name": "полностью аглоязычные запросы",
"position_avg": 13,
"ws1": 142597,
"ws2": 11533,
"ws3": 9990,
"p_traf": 74.84,
"top3_count": 45,
"top5_count": 125,
"top10_count": 326,
"top100_count": 582,
"top3_prc": 7.59,
"top5_prc": 21.08,
"top10_prc": 54.97,
"top100_prc": 98.15,
"ws1_top10": 151,
"ws2_top10": 208,
"ws1_top10_prc": 25.51,
"ws2_top10_prc": 35.06,
"p_traf_prc": 6.49,
"worth": 50,
"worth_max": 540,
"worth_reserve": 490,
"worth_prc": 9.26
},
...
...
],
"count": 20,
"total": 20,
"limit": 100,
"page": 1
},
"version": 1,
"status": 200,
"error": 0,
"error_messages": []
}

Документы

Формат запроса:

GET https://seowork.ru/semantics/api/v4/dashboard/url


Например:

https://seowork.ru/semantics/api/v4/dashboard/url?token=...&project_id=12&date=2019-12-20&search_engine=yandex&page=3

Формат ответа:

{
"data": {
"items": [
{
"date": "2019-12-20",
"search_engine": "yandex",
"id": 565517,
"document": "https://www.mysite.ru/shop/good_id_266656.html",
"category_id": 4226,
"category_name": "уход за волосами",
"queries_count": 13,
"position_avg": 24,
"ws1": 3575,
"ws2": 471,
"ws3": 220,
"p_traf": 0,
"top3_count": 0,
"top5_count": 0,
"top10_count": 3,
"top100_count": 12,
"top3_prc": 0,
"top5_prc": 0,
"top10_prc": 23.08,
"top100_prc": 92.31,
"ws1_top10": 0,
"ws2_top10": 0,
"ws1_top10_prc": 0.48,
"ws2_top10_prc": 0,
"p_traf_prc": 0,
"worth": null,
"worth_max": null,
"worth_reserve": null,
"worth_prc": null
},
...
...
],
"count": 100,
"total": 1400,
"limit": 100,
"page": 3
},
"version": 1,
"status": 200,
"error": 0,
"error_messages": []
}

Запросы

Формат запроса:

GET https://seowork.ru/semantics/api/v4/dashboard/query


Например:

https://seowork.ru/semantics/api/v4/dashboard/query?token=...&project_id=123&date=2019-12-20&search_engine=yandex

Формат ответа:

{
"data": {
"items": [
{
"date": "2019-12-20",
"search_engine": "yandex",
"id": 728970,
"name": "драй драй",
"document_id": 567718,
"document": "https://www.mysite.ru/shop/result.html?mark=166",
"real_document": "https://www.mysite.ru/shop/good_id_166.html",
"rel_document": false,
"position": 53,
"ws1": 12870,
"ws2": 1108,
"ws3": 319,
"p_traf": 0,
"worth": 0,
"worth_max": 5000,
"worth_reserve": 5000,
"worth_prc": 0
},
...
...
],
"count": 100,
"total": 3200,
"limit": 100,
"page": 1
},
"version": 1,
"status": 200,
"error": 0,
"error_messages": []
}




Вы нашли ответ?