API: Проверка посещаемости сайта

Инструмент traffic позволяет получить оценку посещаемости сайта (трафика) по указанному домену.
API возвращает полную статистику по аудитории: визиты, просмотры страниц, рейтинги, географию пользователей, источники трафика и другие метрики.

---

1. Получение API‑ключа

Для работы с API необходимо:

1. Зарегистрироваться на сайте PR‑CY.
2. Получить API‑ключ в настройках API.

---

2. Создание запроса

POST →
https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/

Параметры params

Параметр	Тип	Обязательный	Описание
domain	string	✅	Домен сайта без https:// или http://

---

Пример запроса

curl 'https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/' \
  -H 'accept: application/vnd.api+json' \
  -H 'Api-Key: <ваш_api_ключ>' \
  --data-raw '{
    "data": {
      "type": "toolTasks",
      "attributes": {
        "toolName": "traffic",
        "params": {
          "domain": "ya.ru"
        }
      }
    }
  }'

---

3. Ответ при создании задачи

После отправки POST-запроса API вернёт JSON с ID задачи:

{
  "data": {
    "type": "toolTasks",
    "id": "2a67cb477beceb3a677bcf1592214e24",
    "attributes": { .. }
  }
}

---

4. Получение результата

GET →
https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/{id_задачи}?include=tests

Пример запроса

curl 'https://apis.pr-cy.ru/api/v2.1.0/tool-tasks/2a67cb477beceb3a677bcf1592214e24?include=tests' \
  -H 'accept: application/vnd.api+json' \
  -H 'Api-Key: <ваш_api_ключ>'

---

5. Пример успешного ответа (сокращённый)

{
  "data": {
    "type": "toolTasks",
    "id": "2a67cb477beceb3a677bcf1592214e24",
    "attributes": {...}
  },
  "included": [
    {
      "type": "tests",
      "id": "traffic12345",
      "attributes": {
        "name": "traffic",
        "status": "success",
        "results": {
          "domain": "ya.ru",
          "visitsDaily": 41400,
          "visitsMonthly": 1290000,
          "pageViewsMonthly": 3240000,
          "avgVisitDuration": 180,
          "pagesPerVisit": 3,
          "bounceRate": 44,
          "globalRank": 46957,
          "countryRank": 2726,
          "categoryTopName": "computers_electronics_and_technology",
          "topCountryGeography": [
            { "countryCode": "RU", "percent": 71 },
            { "countryCode": "BY", "percent": 10 },
            { "countryCode": "UA", "percent": 5 }
          ],
          "trafficSources": {
            "organicSearch": 59,
            "direct": 38,
            "social": 1
          },
          "socialTraffic": [
            { "domain": "vk.com", "percent": 60 },
            { "domain": "youtube.com", "percent": 16 },
            { "domain": "telegram.org", "percent": 11 }
          ]
        }
      }
    }
  ]
}

---

6. Ключевые поля в ответе

Поле	Тип	Пример	Описание
visitsDaily	int	41400	Среднее количество визитов в день
visitsMonthly	int	1290000	Среднее количество визитов в месяц
pageViewsMonthly	int	3240000	Просмотры всех страниц за месяц
avgVisitDuration	int	180	Среднее время на сайте (в секундах)
pagesPerVisit	float	3	Среднее количество страниц за визит
bounceRate	int	44	Показатель отказов (%)
globalRank	int	46957	Мировой трафиковый рейтинг
countryRank	int	2726	Рейтинг сайта в главной стране
categoryTopName	string	computers_electronics_and_technology	Тематическая категория сайта
topCountryGeography	array	[{"countryCode": "RU", "percent": 71}, ...]	Страны и доли трафика
trafficSources	object	{"organicSearch": 59, "direct": 38, "social": 1}	Источники трафика, %
socialTraffic	array	[{"domain": "vk.com","percent": 60}]	Топ соцсетей по трафику

---

7. Примечания

• Все значения посещаемости — оценочные, получены из откр. источников и внутренних данных.
• Значения могут отсутствовать, если трафик слишком мал.
• Метрики позволяют анализировать структуру аудитории и динамику по времени.