Анализ сайта
 ...
Тарифы и ценыИнструментыБлогЕщё
 ...
ВходРегистрация

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. Примечания

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

Не нашли нужной информации? Напишите нам в тех.поддержку

🍪 Используя сайт, вы соглашаетесь с обработкой cookie и сбором технических данных для улучшения работы сайта согласно политике конфиденциальности.