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

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

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

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

Зарегистрироваться на сайте PR‑CY.
Получить 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 и сбором технических данных для улучшения работы сайта согласно политике конфиденциальности.

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

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

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

Параметры params

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

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

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

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

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

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

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

Параметры `params`