Shikari API / docs ← Назад
Базовое API · Документация

Эндпоинты Базового API

Публичный API для внешних клиентов-интеграторов. Доступен при активной подписке с включённой опцией «Доступ к API». Возвращает только те результаты, которые доступны вам на сайте. Все ссылки в ответах прямые, без редиректов. Разрешены кросс-доменные запросы (CORS).

Base URL
https://shikari.do
Авторизация
Authorization: Bearer $TOKEN
ENDPOINT

sresults-export

Экспорт заявок (резалтов), доступных вам по подписке, от новых к старым. Продукты (категории, проекты, группы) можно не указывать — тогда вернётся всё, на что у вас есть права.

GET /api/sresults-export
Экспорт заявок (резалтов) для внешнего клиента.
ПараметрInТипОбязателен
limit query integer (1–1000) да
category query array of integer нет
project query array of integer нет
groupset query array of integer нет
from query string (date-time) нет
to query string (date-time) нет
filter query integer (≥1) нет
Пример ответа
{
  "status": "ok",
  "result": [
    {
      "id": "ANhBXpAB8rEubsxy7E5c",
      "date": "2024-06-28T09:51:04.000Z",
      "resource": "ВК",
      "category": "Фото и видеосъемка",
      "user_name": "Лена Ким",
      "message": "Ищу фотографа для фотосессии на природе.",
      "location": "Россия, Нижний Новгород",
      "message_link": "https://shikari.do/sr/ANhBXpAB8rEubsxy7E5c/d458.../",
      "user_avatar": "https://.../avatar.jpg"
    }
  ]
}
ENDPOINT

feed-filters

Список фильтров ленты, привязанных к клиенту — для передачи в параметр filter эндпоинта sresults-export.

GET /api/feed-filters
Список фильтров ленты внешнего клиента.
Пример ответа
{
  "status": "ok",
  "result": [
    {
      "id": 12,
      "name": "Мой фильтр"
    }
  ]
}
ENDPOINT

sr-demo

Демо-виджет: примеры резалтов по категориям для встраивания на внешние сайты. Авторизация не требуется.

GET /api/sr-demo
Примеры резалтов по категориям (демо-виджет).
ПараметрInТипОбязателен
category query array of integer да
limit query integer (≤50) нет
Пример ответа
{
  "status": "ok",
  "result": [
    {
      "category_id": 27,
      "category_name": "Фото и видеосъёмка",
      "id": "ANhBXpAB...",
      "message": "текст заявки",
      "snippet": "сниппет",
      "datetime": "28 июня 09:51",
      "user_ava": "https://.../ava.jpg",
      "location": "Россия, Москва",
      "resourse_name": "ВК",
      "resourse_fav": "https://www.google.com/s2/favicons?domain=vk.com"
    }
  ],
  "msg": ""
}
Нужен доступ или расширенная спецификация под ваш сценарий? Оставьте заявку или напишите на info@shikari.do.
Расширенное API · Документация

Эндпоинты Расширенного API

API краулеров и расширенной инфраструктуры Shikari. Доступ предоставляется по отдельному согласованию. Ниже — ключевые эндпоинты и группы (теги).

Base URL
https://api.shikari.do
Авторизация
Authorization: Bearer $TOKEN
ENDPOINT

soc_stats

Метрики конкретных постов в соцсетях: лайки, комментарии, репосты, просмотры и число подписчиков сообщества (ВК, ОК, Telegram), а также комментарии для ВК. Принимает списком ссылки на посты и отдаёт статистику по каждой. Применяют, чтобы считать эффективность публикаций и рекламных размещений, сравнивать площадки между собой и складывать динамику в свои отчёты и дашборды.

POST /api/soc_stats
Получение статистики о постах в разных соцсетях и о комментах для ВК

В зависимости от соцсети, возвращаются такие данные как: кол-во лайков, комментариев, репостов, просмотров, число подписчиков группы.

Текущий список поддерживаемых соцсетей: ВК, ОК, Телеграм.

Массив ссылок на посты ВК принимает до 100 элементов за один запрос.

Массив ссылок на комменты ВК принимает до 10 элементов за один запрос.

Массив ссылок на посты ОК принимает до 10 элементов за один запрос.

Массив ссылок на посты Тг принимает до 10 элементов за один запрос.

Опция include_text: true добавляет тексты публикаций в успешные элементы ответа; по умолчанию тексты не запрашиваются и не возвращаются.

Тело запроса
{
  "include_text": true,
  "data": {
    "vk": [
      "https://vk.com/wall-125004421_3203530"
    ],
    "vk_comments": [
      "https://vk.com/wall-191450290_7340?reply=7341"
    ],
    "ok": [
      "https://ok.ru/doctorweb/topic/154889734144057"
    ],
    "tg": [
      "https://t.me/addmeto/5281"
    ]
  }
}
Пример ответа
{
  "status": "ok",
  "result": {
    "vk": {
      "https://vk.com/wall-125004421_3203530": {
        "comments": 3,
        "likes": 10,
        "reposts": 5,
        "views": 100,
        "participants": 1000,
        "text": "VK post text <photo>"
      }
    },
    "vk_comments": {
      "https://vk.com/wall-191450290_7340?reply=7341": {
        "likes": 0,
        "comments": 2,
        "text": "<photo> <sticker>"
      }
    },
    "ok": {
      "https://ok.ru/doctorweb/topic/154889734144057": {
        "comments": 6,
        "likes": 9,
        "reposts": 4,
        "participants": 100,
        "text": "OK post text <media>"
      }
    },
    "tg": {
      "https://t.me/addmeto/5281": {
        "views": 57700,
        "likes": 12,
        "participants": 71227,
        "text": "Telegram post text <photo>"
      }
    }
  }
}
ENDPOINT

checkRkn

Проверка, состоит ли группа или канал в перечне зарегистрированных РКН. По ссылке или домену возвращает признак наличия в реестре и данные ресурса. Нужен для комплаенса: проверить площадку перед размещением рекламы, отфильтровать нереестровые каналы в своей выдаче, вести собственный реестр проверенных площадок.

POST /api/utils/checkRkn
Получение информации о нахождении группы/канала в перечне зарегистрированных РКН

Проверка URL по реестру РКН

Тело запроса
{
  "url": "https://t.me/breakingmash"
}
Пример ответа
{
  "success": true,
  "finded": true,
  "data": {
    "name": "Mash",
    "uid": "6726d0b5db0c1931b12fc77f",
    "url": "https://t.me/breakingmash",
    "link": "https://www.gosuslugi.ru/snet/6726d0b5db0c1931b12fc77f"
  }
}
TAG

projects

Проекты мониторинга: создание, чтение, обновление и удаление, а также оценка числа резалтов и их выгрузка. Позволяет полностью управлять мониторингом из своей системы: заводить проекты под клиентов или кампании программно, менять ключевые слова без захода в интерфейс, забирать найденные сообщения в CRM. Отдельный метод отдаёт только изменённые проекты - удобно для инкрементальной синхронизации.

GET /api/projects
Список проектов

Пользователь определяется по токену. Сортировка по дате создания проекта.

ПараметрInТипОбязателен
fields query string нет
limit query integer нет
offset query integer нет
Пример ответа
{
  "success": true,
  "count": 12,
  "data": [
    {
      "name": "СМИ-монитор: 10 фев 2022 (+5)",
      "description": "",
      "local": false,
      "keywords": "день,газета,небо,погода,ночь,добрый,злой",
      "keywords_exclude": "",
      "context": "",
      "title_include": true,
      "pos_obj": 0,
      "neg_obj": 0,
      "types": [
        0
      ],
      "excluded_urls": "",
      "last_scan": "2023-04-07T07:24:53",
      "interval": 100,
      "user": 14,
      "lock": false,
      "lock_by": 0,
      "neural_analysis": false,
      "tonality_realtime": false,
      "censor_filter": true,
      "archive": false,
      "type": "",
      "deleted": false,
      "group": "",
      "difficulty": {
        "result_cnt": 0,
        "run_cnt": 0,
        "time": 0,
        "keyword_cnt": 0
      },
      "res_include": [
        9827
      ],
      "res_exclude": [
        8719
      ],
      "parent": "",
      "child_context": "",
      "post_type": "all",
      "createdAt": "2022-02-21T09:32:49.841Z",
      "updatedAt": "2022-02-24T08:21:37.179Z"
    }
  ]
}
GET /api/projects_updated
Обновлённые проекты

id проектов, чьи результаты обновлялись после указанного времени

ПараметрInТипОбязателен
since query string нет
Пример ответа
{
  "success": true,
  "projects": [
    2395
  ]
}
GET /api/project/{id}
Чтение проекта

Проект по id

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true,
  "data": [
    {
      "name": "СМИ-монитор: 10 фев 2022 (+5)",
      "description": "",
      "local": false,
      "keywords": "день,газета,небо,погода,ночь,добрый,злой",
      "keywords_exclude": "",
      "context": "",
      "title_include": true,
      "pos_obj": 0,
      "neg_obj": 0,
      "types": [
        0
      ],
      "excluded_urls": "",
      "last_scan": "2023-04-07T07:24:53",
      "interval": 100,
      "user": 14,
      "lock": false,
      "lock_by": 0,
      "neural_analysis": false,
      "tonality_realtime": false,
      "censor_filter": true,
      "archive": false,
      "type": "",
      "deleted": false,
      "group": "",
      "difficulty": {
        "result_cnt": 0,
        "run_cnt": 0,
        "time": 0,
        "keyword_cnt": 0
      },
      "res_include": [
        9827
      ],
      "res_exclude": [
        8719
      ],
      "parent": "",
      "child_context": "",
      "post_type": "all",
      "createdAt": "2022-02-21T09:32:49.841Z",
      "updatedAt": "2022-02-24T08:21:37.179Z"
    }
  ]
}
PUT /api/project/{id}
Обновление проекта

Обновление проекта

ПараметрInТипОбязателен
id path string да
Тело запроса
{
  "name": "СМИ-монитор: 10 фев 2022 (+5)",
  "description": "",
  "local": false,
  "keywords": "день,газета,небо,погода,ночь,добрый,злой",
  "keywords_exclude": "",
  "context": "",
  "title_include": true,
  "pos_obj": 0,
  "neg_obj": 0,
  "types": [
    0
  ],
  "excluded_urls": "",
  "last_scan": "2023-04-07T07:24:53",
  "interval": 100,
  "user": 14,
  "lock": false,
  "lock_by": 0,
  "neural_analysis": false,
  "tonality_realtime": false,
  "censor_filter": true,
  "archive": false,
  "type": "",
  "deleted": false,
  "group": "",
  "difficulty": {
    "result_cnt": 0,
    "run_cnt": 0,
    "time": 0,
    "keyword_cnt": 0
  },
  "res_include": [
    9827
  ],
  "res_exclude": [
    8719
  ],
  "parent": "",
  "child_context": "",
  "post_type": "all",
  "createdAt": "2022-02-21T09:32:49.841Z",
  "updatedAt": "2022-02-24T08:21:37.179Z"
}
Пример ответа
{
  "success": true,
  "data": [
    {
      "name": "СМИ-монитор: 10 фев 2022 (+5)",
      "description": "",
      "local": false,
      "keywords": "день,газета,небо,погода,ночь,добрый,злой",
      "keywords_exclude": "",
      "context": "",
      "title_include": true,
      "pos_obj": 0,
      "neg_obj": 0,
      "types": [
        0
      ],
      "excluded_urls": "",
      "last_scan": "2023-04-07T07:24:53",
      "interval": 100,
      "user": 14,
      "lock": false,
      "lock_by": 0,
      "neural_analysis": false,
      "tonality_realtime": false,
      "censor_filter": true,
      "archive": false,
      "type": "",
      "deleted": false,
      "group": "",
      "difficulty": {
        "result_cnt": 0,
        "run_cnt": 0,
        "time": 0,
        "keyword_cnt": 0
      },
      "res_include": [
        9827
      ],
      "res_exclude": [
        8719
      ],
      "parent": "",
      "child_context": "",
      "post_type": "all",
      "createdAt": "2022-02-21T09:32:49.841Z",
      "updatedAt": "2022-02-24T08:21:37.179Z"
    }
  ]
}
DELETE /api/project/{id}
Удаление проекта

Удаление проекта (soft-delete: deleted=true)

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": false
}
POST /api/project
Создание проекта

Синтаксис ключевых слов см. тут

Тело запроса
{
  "name": "СМИ-монитор: 10 фев 2022 (+5)",
  "description": "",
  "local": false,
  "keywords": "день,газета,небо,погода,ночь,добрый,злой",
  "keywords_exclude": "",
  "context": "",
  "title_include": true,
  "pos_obj": 0,
  "neg_obj": 0,
  "types": [
    0
  ],
  "excluded_urls": "",
  "last_scan": "2023-04-07T07:24:53",
  "interval": 100,
  "user": 14,
  "lock": false,
  "lock_by": 0,
  "neural_analysis": false,
  "tonality_realtime": false,
  "censor_filter": true,
  "archive": false,
  "type": "",
  "deleted": false,
  "group": "",
  "difficulty": {
    "result_cnt": 0,
    "run_cnt": 0,
    "time": 0,
    "keyword_cnt": 0
  },
  "res_include": [
    9827
  ],
  "res_exclude": [
    8719
  ],
  "parent": "",
  "child_context": "",
  "post_type": "all",
  "createdAt": "2022-02-21T09:32:49.841Z",
  "updatedAt": "2022-02-24T08:21:37.179Z"
}
Пример ответа
{
  "success": true,
  "data": [
    {
      "name": "СМИ-монитор: 10 фев 2022 (+5)",
      "description": "",
      "local": false,
      "keywords": "день,газета,небо,погода,ночь,добрый,злой",
      "keywords_exclude": "",
      "context": "",
      "title_include": true,
      "pos_obj": 0,
      "neg_obj": 0,
      "types": [
        0
      ],
      "excluded_urls": "",
      "last_scan": "2023-04-07T07:24:53",
      "interval": 100,
      "user": 14,
      "lock": false,
      "lock_by": 0,
      "neural_analysis": false,
      "tonality_realtime": false,
      "censor_filter": true,
      "archive": false,
      "type": "",
      "deleted": false,
      "group": "",
      "difficulty": {
        "result_cnt": 0,
        "run_cnt": 0,
        "time": 0,
        "keyword_cnt": 0
      },
      "res_include": [
        9827
      ],
      "res_exclude": [
        8719
      ],
      "parent": "",
      "child_context": "",
      "post_type": "all",
      "createdAt": "2022-02-21T09:32:49.841Z",
      "updatedAt": "2022-02-24T08:21:37.179Z"
    }
  ]
}
POST /api/project/{id}/estimate-results
Оценка числа резалтов

Примерный подсчёт количества резалтов по проекту (ES count)

ПараметрInТипОбязателен
id path string да
Тело запроса
{
  "last_scan": "2023-04-07T07:24:53",
  "censor_filter": true
}
Пример ответа
{
  "success": true,
  "data": 0
}
POST /api/project/{id}/results-data
Резалты по проекту

Сортировка: от более новых, к более старым. Время жизни поискового окна - 3мин.

ПараметрInТипОбязателен
id path string да
Тело запроса
{
  "after_time": "2023-04-04T07:12:42",
  "before_time": "2023-04-07T09:24:53",
  "censor_filter": true,
  "soc_groups": [
    50415375614101
  ],
  "resources": [
    38
  ],
  "count": 10,
  "anchor": "eyJwaXQiOnsiaWQiOiJpX3ZyQXd3RmFXTmZkak1XUVRka1JsbFBXbkZTVVVOdExUWjVWa1ppTFRsRWR3RVdPVEJsT0dsVmNsaFJSRTl3YVZaNlpGTm5OWGxtVVFBQUFBQUFBQkZqa1JaU1ZuWnFNazU0T1ZKbExYTXpRa2xTVFVwdVkzcG5BQVZwWTE5Mk14WkJOMlJHV1U5YWNWSlJRMjB0Tm5sV1JtSXRPVVIzQWhZNU1HVTRhVlZ5V0ZGRVQzQnBWbnBrVTJjMWVXWlJBQUFBQUFBQUVXT1NGbEpXZG1veVRuZzVVbVV0Y3pOQ1NWSk5TbTVqZW1jQUJXbGpYM1l6RmtFM1pFWlpUMXB4VWxGRGJTMDJlVlpHWWkwNVJIY0RGamt3WlRocFZYSllVVVJQY0dsV2VtUlRaelY1WmxFQUFBQUFBQUFSWTVNV1VsWjJhakpPZURsU1pTMXpNMEpKVWsxS2JtTjZad0FGYVdOZmRqTVdRVGRrUmxsUFduRlNVVU50TFRaNVZrWmlMVGxFZHdRV09UQmxPR2xWY2xoUlJFOXdhVlo2WkZObk5YbG1VUUFBQUFBQUFCRmpsQlpTVm5acU1rNTRPVkpsTFhNelFrbFNUVXB1WTNwbkFBVnBZMTkyTXhaQk4yUkdXVTlhY1ZKUlEyMHRObmxXUm1JdE9VUjNBQlk1TUdVNGFWVnlXRkZFVDNCcFZucGtVMmMxZVdaUkFBQUFBQUFBRVdPUUZsSldkbW95VG5nNVVtVXRjek5DU1ZKTlNtNWplbWNBQldsalgzWXpGa0UzWkVaWlQxcHhVbEZEYlMwMmVWWkdZaTA1UkhjSkZqa3daVGhwVlhKWVVVUlBjR2xXZW1SVFp6VjVabEVBQUFBQUFBQVJZNWtXVWxaMmFqSk9lRGxTWlMxek0wSkpVazFLYm1ONlp3QUZhV05mZGpNV1FUZGtSbGxQV25GU1VVTnRMVFo1VmtaaUxUbEVkd29XT1RCbE9HbFZjbGhSUkU5d2FWWjZaRk5uTlhsbVVRQUFBQUFBQUJGam1oWlNWblpxTWs1NE9WSmxMWE16UWtsU1RVcHVZM3BuQUFWcFkxOTJNeFpCTjJSR1dVOWFjVkpSUTIwdE5ubFdSbUl0T1VSM0N4WTVNR1U0YVZWeVdGRkVUM0JwVm5wa1UyYzFlV1pSQUFBQUFBQUFFV09iRmxKV2Rtb3lUbmc1VW1VdGN6TkNTVkpOU201amVtY0FCV2xqWDNZekZrRTNaRVpaVDFweFVsRkRiUzAyZVZaR1lpMDVSSGNGRmprd1pUaHBWWEpZVVVSUGNHbFdlbVJUWnpWNVpsRUFBQUFBQUFBUlk1VVdVbFoyYWpKT2VEbFNaUzF6TTBKSlVrMUtibU42WndBRmFXTmZkak1XUVRka1JsbFBXbkZTVVVOdExUWjVWa1ppTFRsRWR3WVdPVEJsT0dsVmNsaFJSRTl3YVZaNlpGTm5OWGxtVVFBQUFBQUFBQkZqbGhaU1ZuWnFNazU0T1ZKbExYTXpRa2xTVFVwdVkzcG5BQVZwWTE5Mk14WkJOMlJHV1U5YWNWSlJRMjB0Tm5sV1JtSXRPVVIzQnhZNU1HVTRhVlZ5V0ZGRVQzQnBWbnBrVTJjMWVXWlJBQUFBQUFBQUVXT1hGbEpXZG1veVRuZzVVbVV0Y3pOQ1NWSk5TbTVqZW1jQUJXbGpYM1l6RmtFM1pFWlpUMXB4VWxGRGJTMDJlVlpHWWkwNVJIY0lGamt3WlRocFZYSllVVVJQY0dsV2VtUlRaelY1WmxFQUFBQUFBQUFSWTVnV1VsWjJhakpPZURsU1pTMXpNMEpKVWsxS2JtTjZad0FCRmtFM1pFWlpUMXB4VWxGRGJTMDJlVlpHWWkwNVJIY0FBQT09Iiwia2VlcF9hbGl2ZSI6IjFtIn0sInNlYXJjaF9hZnRlciI6WzE2ODA2MDE5NjIwMDAsMzAwNjQ3NzQyMzFdfQ=="
}
Пример ответа
{
  "success": true,
  "data": [
    {
      "resource": 38,
      "type": 2,
      "data_title": "Инна Ушакова @529743996700",
      "data": "небыло там отродясь никакого влияния. ну что вы в самом деле",
      "url": "https://ok.ru/group/50415375614101/topic/155934392413589#MTY4MDY4OTA5MjQyNzotMTI3MzE6MTY4MDY4OTA5MjQyNzoxNTU5MzQzOTI0MTM1ODk6MQ==",
      "crawl_time": "2023-04-05T11:58:51",
      "status": 1,
      "lock": false,
      "author_id": "529743996700",
      "ic_group_id": "50415375614101",
      "author_url": "https://ok.ru/profile/529743996700",
      "author_ava": "https://i.mycdn.me/i?r=AzE2N9xcmpglxEQIrzrT0bivd1EZ8sFv1gx8kk0rcgJS0MV3dMiZbxanWQO_vZWgIYU",
      "author": "Инна Ушакова",
      "_id": "98ad624287168ee1c3dde43fe58df877",
      "datetime": "2023-04-05T10:45:11",
      "post_type": "reply",
      "data_location": "Россия, Москва",
      "author_location": "Россия, Екатеринбург",
      "followers_count": 465
    }
  ],
  "anchor": "string"
}
TAG

project_monitor

Управление списком соц-групп, привязанных к проекту мониторинга: получить, создать, обновить, удалить. Применяют, когда нужно следить за конкретным набором сообществ - например, за площадками конкурентов или за отраслевыми пабликами, - и поддерживать этот список из своей системы.

GET /api/project/{id}/soc_groups
Группы мониторинга проекта

Соц-группы, привязанные к мониторингу проекта

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true,
  "data": [
    {
      "res": "38",
      "id": "7177127051",
      "group_id": "51480214634672",
      "group_name": "РИА Новости",
      "group_alias": "ria",
      "createdAt": "2020-07-17T12:11:57.375Z",
      "updatedAt": "2023-04-07T16:24:01.896Z",
      "group_type": "string",
      "err_cnt": 0,
      "in_rkn": true,
      "has_access": true,
      "meta": {
        "link": "https://ok.ru/group/50517785378969",
        "ava": "//i.mycdn.me/image?id=853724739749&t=32&plc=MOBILE&tkn=*W72OVjkM3Gajye6Ol328pOQH_pk",
        "can_crawl": true,
        "followers_count": 12987546,
        "alias": "ria",
        "is_closed": false
      }
    }
  ],
  "params": {
    "id": "574"
  }
}
POST /api/project/{id}/soc_groups
Создать мониторинг проекта

Важно: если создан проект мониторинга, то поиск по ключевым словам и айди пользователей не работает. Проект мониторинга собирает все сообщения из чатов.

ПараметрInТипОбязателен
id path string да
Тело запроса
{
  "soc_groups": [
    7172882249
  ]
}
Пример ответа
{
  "success": true,
  "data": {
    "project_id": "19414",
    "soc_groups": [
      7172882249
    ],
    "createdAt": "2023-01-12 16:35:50",
    "updatedAt": "2023-01-27 15:34:15"
  }
}
PUT /api/project/{id}/soc_groups
Обновить мониторинг проекта

Обновление списка соц-групп в мониторинге проекта. Если записи мониторинга ещё нет, она будет создана.

ПараметрInТипОбязателен
id path string да
Тело запроса
{
  "soc_groups": [
    7172882249
  ]
}
Пример ответа
{
  "success": true,
  "data": {
    "project_id": "19414",
    "soc_groups": [
      7172882249
    ],
    "createdAt": "2023-01-12 16:35:50",
    "updatedAt": "2023-01-27 15:34:15"
  },
  "params": {
    "id": "574"
  }
}
DELETE /api/project/{id}/soc_groups
Удалить мониторинг проекта

После удаления становится обычным проектом, работающим по ключевым словам

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true,
  "params": {
    "id": "574"
  }
}
TAG

soc_groups

Справочник социальных групп и сообществ: список, чтение, подписка и отписка, а также резолвинг группы по ссылке или по внутреннему id. Резолвинг - основной сценарий интеграции: у вас есть ссылка на сообщество, а нужен внутренний идентификатор Shikari, чтобы дальше работать с ним в проектах и статистике.

GET /api/soc_groups
Список соц-групп

Сортировка по id.

ПараметрInТипОбязателен
resources query string нет
limit query integer нет
offset query integer нет
Пример ответа
{
  "success": true,
  "count": 123456,
  "data": [
    {
      "res": "38",
      "id": "7177127051",
      "group_id": "51480214634672",
      "group_name": "РИА Новости",
      "group_alias": "ria",
      "createdAt": "2020-07-17T12:11:57.375Z",
      "updatedAt": "2023-04-07T16:24:01.896Z",
      "group_type": "string",
      "err_cnt": 0,
      "in_rkn": true,
      "has_access": true,
      "meta": {
        "link": "https://ok.ru/group/50517785378969",
        "ava": "//i.mycdn.me/image?id=853724739749&t=32&plc=MOBILE&tkn=*W72OVjkM3Gajye6Ol328pOQH_pk",
        "can_crawl": true,
        "followers_count": 12987546,
        "alias": "ria",
        "is_closed": false
      }
    }
  ]
}
GET /api/soc_group/{id}
Чтение соц-группы

Метод разработан для операторов (ссылки высылаются в email) и доступен при наличии авторизации в админке. Одновременно с этим возможно работа без авторизации по токену.

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true,
  "data": {
    "res": "38",
    "id": "7177127051",
    "group_id": "51480214634672",
    "group_name": "РИА Новости",
    "group_alias": "ria",
    "createdAt": "2020-07-17T12:11:57.375Z",
    "updatedAt": "2023-04-07T16:24:01.896Z",
    "group_type": "string",
    "err_cnt": 0,
    "in_rkn": true,
    "has_access": true,
    "meta": {
      "link": "https://ok.ru/group/50517785378969",
      "ava": "//i.mycdn.me/image?id=853724739749&t=32&plc=MOBILE&tkn=*W72OVjkM3Gajye6Ol328pOQH_pk",
      "can_crawl": true,
      "followers_count": 12987546,
      "alias": "ria",
      "is_closed": false
    }
  },
  "params": {
    "id": "574"
  }
}
GET /api/soc_group/{id}/subscribe
Подписка на группу

Метод разработан для операторов (ссылки высылаются в email) и доступен при наличии авторизации в админке. . Одновременно с этим возможно работа без авторизации по токену.

ПараметрInТипОбязателен
id path string да
url query string нет
Пример ответа
{
  "success": true,
  "data": {
    "res": "38",
    "id": "7177127051",
    "group_id": "51480214634672",
    "group_name": "РИА Новости",
    "group_alias": "ria",
    "createdAt": "2020-07-17T12:11:57.375Z",
    "updatedAt": "2023-04-07T16:24:01.896Z",
    "group_type": "string",
    "err_cnt": 0,
    "in_rkn": true,
    "has_access": true,
    "meta": {
      "link": "https://ok.ru/group/50517785378969",
      "ava": "//i.mycdn.me/image?id=853724739749&t=32&plc=MOBILE&tkn=*W72OVjkM3Gajye6Ol328pOQH_pk",
      "can_crawl": true,
      "followers_count": 12987546,
      "alias": "ria",
      "is_closed": false
    }
  },
  "params": {
    "id": "574"
  }
}
GET /api/soc_group/{id}/unsubscribe
Отписка от группы

Метод разработан для операторов (ссылки высылаются в email) и доступен при наличии авторизации в админке. . Одновременно с этим возможно работа без авторизации по токену.

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true,
  "data": {
    "res": "38",
    "id": "7177127051",
    "group_id": "51480214634672",
    "group_name": "РИА Новости",
    "group_alias": "ria",
    "createdAt": "2020-07-17T12:11:57.375Z",
    "updatedAt": "2023-04-07T16:24:01.896Z",
    "group_type": "string",
    "err_cnt": 0,
    "in_rkn": true,
    "has_access": true,
    "meta": {
      "link": "https://ok.ru/group/50517785378969",
      "ava": "//i.mycdn.me/image?id=853724739749&t=32&plc=MOBILE&tkn=*W72OVjkM3Gajye6Ol328pOQH_pk",
      "can_crawl": true,
      "followers_count": 12987546,
      "alias": "ria",
      "is_closed": false
    }
  },
  "params": {
    "id": "574"
  }
}
POST /api/soc_groups/resolve_by_link
Резолв групп по ссылкам

При успешном резолве группа добавляется/обновляется в БД

ПараметрInТипОбязателен
getEScnt query string нет
Тело запроса
[
  "https://ok.ru/group/51480214634672"
]
Пример ответа
{
  "success": true,
  "data": [
    {
      "success": true,
      "link": "https://ok.ru/group/51480214634672",
      "data": {
        "res": "38",
        "id": "7177127051",
        "group_id": "51480214634672",
        "group_name": "РИА Новости",
        "group_alias": "ria",
        "createdAt": "2020-07-17T12:11:57.375Z",
        "updatedAt": "2023-04-07T16:24:01.896Z",
        "group_type": "string",
        "err_cnt": 0,
        "in_rkn": true,
        "has_access": true,
        "meta": {
          "link": "https://ok.ru/group/50517785378969",
          "ava": "//i.mycdn.me/image?id=853724739749&t=32&plc=MOBILE&tkn=*W72OVjkM3Gajye6Ol328pOQH_pk",
          "can_crawl": true,
          "followers_count": 12987546,
          "alias": "ria",
          "is_closed": false
        }
      }
    }
  ]
}
POST /api/soc_groups/resolve_by_id
Резолв групп по id

Резолв соц-групп по внутренним id. Тело запроса — массив id.

Тело запроса
[
  "7177127051"
]
Пример ответа
{
  "success": true,
  "data": [
    {
      "success": true,
      "id": "7177127051",
      "data": {
        "res": "38",
        "id": "7177127051",
        "group_id": "51480214634672",
        "group_name": "РИА Новости",
        "group_alias": "ria",
        "createdAt": "2020-07-17T12:11:57.375Z",
        "updatedAt": "2023-04-07T16:24:01.896Z",
        "group_type": "string",
        "err_cnt": 0,
        "in_rkn": true,
        "has_access": true,
        "meta": {
          "link": "https://ok.ru/group/50517785378969",
          "ava": "//i.mycdn.me/image?id=853724739749&t=32&plc=MOBILE&tkn=*W72OVjkM3Gajye6Ol328pOQH_pk",
          "can_crawl": true,
          "followers_count": 12987546,
          "alias": "ria",
          "is_closed": false
        }
      }
    }
  ]
}
TAG

sresults

Поисковые результаты (резалты) - найденные сообщения. Чтение одного результата по id документа и получение списка по массиву id. Применяют для дозагрузки деталей: например, вы получили id через push или выгрузку, а теперь нужен полный текст, автор, ссылка и время публикации, чтобы положить карточку в CRM.

GET /api/sresult/{id}
Чтение поискового результата

Поисковый результат по id документа в push-формате (pg searchresult2 + ES)

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true,
  "sresult": {
    "document": "5651af06425222c6db2e8ad6f0ca6120",
    "found": true,
    "res": "30",
    "datetime": "2020-07-17T12:11:57.375Z",
    "user_msg": "Куплю обувь боксерки, борцовки, самбовки",
    "user_msg_link": "https://vk.com/wall-107761772_137301",
    "user_ava": "https://sun1-55.userapi.com/s/v1/ig2/nSYbTBw280VoaMITtS_6bQHCYiUixjpM_mrGxUrezLTSsFfwui1YZk-uPdeH1xHK8bN0QLUWjje36e3QjxYux0ph.jpg?size=100x100&quality=95&crop=22,11,367,367&ava=1",
    "user_link": "https://vk.com/obyavleniya_taygi",
    "user_id": 107761772,
    "user_screen_name": "svoyshvillo",
    "user_name": "Объявления Тайга",
    "user_location": "Россия, Тайга",
    "user_phone": "79991112233",
    "user_email": "em@il.ru",
    "neural_score": 0.876,
    "meta": {
      "group_name": "Объявления Тайга",
      "group_id": "107761772",
      "ic_group_id": "7140541007",
      "data_hash": "8608909850430451549",
      "post_type": "post"
    }
  }
}
GET /api/sresults
Список поисковых результатов по массиву id

Пакетное чтение поисковых результатов по массиву id документов.

Обратите внимание: массив ids передаётся JSON-телом GET-запроса.

Пример ответа
{
  "success": true,
  "sresults": [
    {
      "document": "5651af06425222c6db2e8ad6f0ca6120",
      "found": true,
      "res": "30",
      "datetime": "2020-07-17T12:11:57.375Z",
      "user_msg": "Куплю обувь боксерки, борцовки, самбовки",
      "user_msg_link": "https://vk.com/wall-107761772_137301",
      "user_ava": "https://sun1-55.userapi.com/s/v1/ig2/nSYbTBw280VoaMITtS_6bQHCYiUixjpM_mrGxUrezLTSsFfwui1YZk-uPdeH1xHK8bN0QLUWjje36e3QjxYux0ph.jpg?size=100x100&quality=95&crop=22,11,367,367&ava=1",
      "user_link": "https://vk.com/obyavleniya_taygi",
      "user_id": 107761772,
      "user_screen_name": "svoyshvillo",
      "user_name": "Объявления Тайга",
      "user_location": "Россия, Тайга",
      "user_phone": "79991112233",
      "user_email": "em@il.ru",
      "neural_score": 0.876,
      "meta": {
        "group_name": "Объявления Тайга",
        "group_id": "107761772",
        "ic_group_id": "7140541007",
        "data_hash": "8608909850430451549",
        "post_type": "post"
      }
    }
  ]
}
TAG

stats_projects

Стат-проекты - отслеживание динамики сообществ. Управление проектами (в том числе массовое создание), история постов и аудитории, агрегаты по подписчикам, пересечения аудиторий разных сообществ и выгрузки за произвольный период. Самая большая группа методов: её берут для аналитики - смотреть рост площадок, сравнивать аудитории, искать пересечения перед закупкой рекламы и строить BI-отчёты.

GET /api/stats_projects
Список стат-проектов

Пользователь определяется по токену. Сортировка по дате создания проекта.

ПараметрInТипОбязателен
limit query integer нет
offset query integer нет
Пример ответа
{
  "success": true,
  "count": 12,
  "data": [
    {
      "id": 38,
      "res": 30,
      "ic_group_id": "7172945007",
      "user_id": 27,
      "enable": false,
      "last_scan": "2020-07-17T12:11:57.375Z",
      "last_scan_audience": "2020-07-17T12:11:57.375Z",
      "retrospective": 30,
      "interval": 86400,
      "tonality": false,
      "created_at": "2020-07-17T12:11:57.375Z",
      "updated_at": "2023-04-07T16:24:01.896Z"
    }
  ]
}
GET /api/stats_projects_updated
Обновлённые стат-проекты

Возвращает два списка. Post: проекты, имеющие обновления публикаций. Audience: проекты, имеющие обновления аудитории.

ПараметрInТипОбязателен
since query string нет
Пример ответа
{
  "success": true,
  "posts": [
    2395
  ],
  "audience": [
    1834
  ]
}
POST /api/stats_project_bulk
Массовое создание стат-проектов

Массовое создание стат-проектов по списку id соц-групп. Ответ содержит по элементу на каждую уникальную группу: повторы в списке схлопываются. Ошибка по отдельной группе (не найдена или проект уже создан) не отменяет создание остальных.

Обратите внимание: в отличие от создания одиночного проекта, interval здесь не ограничивается снизу.

Тело запроса
{
  "interval": 86400,
  "retrospective": 30,
  "tonality": true,
  "ic_group_ids": [
    7172945007
  ]
}
Пример ответа
{
  "success": true,
  "data": [
    {
      "success": true,
      "ic_group_id": 7172945007,
      "data": {
        "id": 38,
        "res": 30,
        "ic_group_id": "7172945007",
        "user_id": 27,
        "enable": false,
        "last_scan": "2020-07-17T12:11:57.375Z",
        "last_scan_audience": "2020-07-17T12:11:57.375Z",
        "retrospective": 30,
        "interval": 86400,
        "tonality": false,
        "created_at": "2020-07-17T12:11:57.375Z",
        "updated_at": "2023-04-07T16:24:01.896Z"
      }
    }
  ]
}
POST /api/stats_project
Создание стат-проекта

Создание стат-проекта по id соц-группы. Значение interval поднимается до минимума 3600 секунд.

Ошибки «группа не найдена» (404) и «проект уже создан» (409) возвращаются с HTTP 200 и полем code в теле ответа.

Тело запроса
{
  "interval": 86400,
  "retrospective": 30,
  "tonality": true,
  "ic_group_id": 7172945007
}
Пример ответа
{
  "ic_group_id": 7172945007,
  "success": true,
  "data": {
    "id": 38,
    "res": 30,
    "ic_group_id": "7172945007",
    "user_id": 27,
    "enable": false,
    "last_scan": "2020-07-17T12:11:57.375Z",
    "last_scan_audience": "2020-07-17T12:11:57.375Z",
    "retrospective": 30,
    "interval": 86400,
    "tonality": false,
    "created_at": "2020-07-17T12:11:57.375Z",
    "updated_at": "2023-04-07T16:24:01.896Z"
  },
  "error": "string",
  "code": 0
}
GET /api/stats_project/{id}
Чтение стат-проекта

Стат-проект по id. Служебное поле settings в ответ не попадает.

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true,
  "data": {
    "id": 38,
    "res": 30,
    "ic_group_id": "7172945007",
    "user_id": 27,
    "enable": false,
    "last_scan": "2020-07-17T12:11:57.375Z",
    "last_scan_audience": "2020-07-17T12:11:57.375Z",
    "retrospective": 30,
    "interval": 86400,
    "tonality": false,
    "created_at": "2020-07-17T12:11:57.375Z",
    "updated_at": "2023-04-07T16:24:01.896Z"
  }
}
PUT /api/stats_project/{id}
Обновление стат-проекта

Частичное обновление стат-проекта. Значение interval поднимается до минимума 3600 секунд.

Обратите внимание: запрос без поля tonality сбрасывает его в false.

ПараметрInТипОбязателен
id path string да
Тело запроса
{
  "enable": true,
  "retrospective": 30,
  "interval": 86400,
  "tonality": true,
  "last_scan": "2023-11-17T12:11:57.375Z"
}
Пример ответа
{
  "success": true,
  "data": {
    "id": 38,
    "res": 30,
    "ic_group_id": "7172945007",
    "user_id": 27,
    "enable": false,
    "last_scan": "2020-07-17T12:11:57.375Z",
    "last_scan_audience": "2020-07-17T12:11:57.375Z",
    "retrospective": 30,
    "interval": 86400,
    "tonality": false,
    "created_at": "2020-07-17T12:11:57.375Z",
    "updated_at": "2023-04-07T16:24:01.896Z"
  }
}
DELETE /api/stats_project/{id}
Удаление (выключение) стат-проекта

«Удаление» стат-проекта: запись не удаляется, а выключается — проекту проставляется enable = false.

ПараметрInТипОбязателен
id path string да
Пример ответа
{
  "success": true
}
GET /api/stats_by_project/{id}/group_history/{history}
История подписчиков стат-проекта

История подписчиков группы стат-проекта за последние history дней.

При history=1 отдаются актуальные данные группы, при большем значении — сохранённая история.

ПараметрInТипОбязателен
id path string да
history path string да
Пример ответа
{
  "success": true,
  "data": [
    {
      "id": 7,
      "ic_group_id": "7172945007",
      "followers": 81348,
      "created_at": "2020-07-17T12:11:57.375Z"
    }
  ]
}
GET /api/stats_by_project/{id}/{period}/post_history
Посты стат-проекта за период

Посты группы стат-проекта, опубликованные за последние period дней.

ПараметрInТипОбязателен
id path string да
period path string да
Пример ответа
{
  "success": true,
  "data": [
    {
      "id": 7,
      "ic_group_id": "7140541007",
      "url": "https://vk.com/wall-220471712_228",
      "type": "post",
      "post_title": "ANTON LETUCHIY",
      "post_content": "Стейк <video>",
      "pinned": false,
      "likes": 12,
      "views": 1450,
      "reposts": 4,
      "comments": 9,
      "reactions": 0,
      "tonality": "positive",
      "posted_at": "2020-07-17T12:11:57.375Z",
      "image": "https://admin.shikari.do/tg/images/5361997460965890040.jpg",
      "createdAt": "2020-07-17T12:11:57.375Z",
      "updatedAt": "2020-07-17T12:11:57.375Z"
    }
  ]
}
GET /api/stats_by_project/{id}/audience/aggr_history
История агрегатов аудитории

Сортировка от новых к старым

ПараметрInТипОбязателен
id path string да
fields query string нет
period query string нет
Пример ответа
{
  "success": true,
  "data": [
    {
      "id": 38,
      "audienceTotal": 333000,
      "updatedAt": "2024-04-15T12:11:57.375Z",
      "age": [
        {
          "range": "13-17",
          "pct": 35,
          "abs": 129
        }
      ],
      "sex": [
        {
          "range": "13-17",
          "M": {
            "pct": 10,
            "abs": 85
          },
          "F": {
            "pct": 12,
            "abs": 104
          }
        }
      ],
      "top20": [
        {
          "ava": "https://sun1-92.userapi.com/s/v1/ig2/kCoxFmxNBID4WO6HLXNb7968tddBNA8TiVqtpqbZZ2hHz57QwNyaT1UVxXoP-ls0G-Mt8CGho2stK9pCSwLG0J75.jpg?size=320x320&quality=96&crop=0,0,320,320&ava=1",
          "link": "https://vk.com/id595637637",
          "name": "Nataliya Nati",
          "followers_count": 15672
        }
      ],
      "socCap": [
        {
          "range": "11-100",
          "pct": 21,
          "abs": 98
        }
      ],
      "reach": [
        {
          "range": "501-1000",
          "pct": 8,
          "abs": 15
        }
      ],
      "city": [
        {
          "name": "Москва",
          "pct": 92,
          "abs": 843
        }
      ],
      "country": [
        {
          "name": "Россия",
          "pct": 97,
          "abs": 991
        }
      ],
      "race": {
        "<ключ>": {
          "pct": 98,
          "abs": 197
        }
      },
      "life": 87,
      "russians": 92,
      "massFollowers": 14,
      "bots": 11
    }
  ]
}
GET /api/stats_by_project/audience/intersection
Пересечение аудиторий стат-проектов

Пересечение аудиторий двух и более стат-проектов одной соцсети. Считается ES-агрегациями: по каждой паре возвращается общий размер аудитории, число и доля общих подписчиков и уникальных.

ПараметрInТипОбязателен
ids query string нет
mode query string нет
Пример ответа
{
  "success": true,
  "data": {
    "<ключ>": {
      "total": 28107,
      "intersection": {
        "abs": 172,
        "pct": 0.61
      },
      "unique": {
        "abs": 27935,
        "pct": 99.39
      }
    }
  },
  "count": 0,
  "updatedAt": "string"
}
GET /api/stats_by_period/posts
Стрим постов за период

Возвращает посты по всем активным стат.проектам клиента (определяется по токену).
Можно ограничить список проектов через параметр stats_project_ids. Если в списке есть несуществующие или недоступные клиенту проекты, возвращается ошибка. Период создания задается параметрами start_date и end_date.
Дополнительно можно фильтровать по дате обновления через updated_since.

Важно: потоковая выдача в формате JSON Lines (каждая строка ответа содержит один JSON-объект поста).

ПараметрInТипОбязателен
start_date query string да
end_date query string да
updated_since query string нет
stats_project_ids query string нет
fields query string нет
Пример ответа
"{\"id\":123,\"ic_group_id\":456,\"posted_at\":\"2026-04-01T10:00:00+00:00\",\"created_at\":\"2026-04-01T10:05:00+00:00\",\"updated_at\":\"2026-04-02T12:00:00+00:00\",\"stats_project_id\":42}\n{\"id\":124,\"ic_group_id\":456,\"posted_at\":\"2026-04-01T11:00:00+00:00\",\"created_at\":\"2026-04-01T11:05:00+00:00\",\"updated_at\":\"2026-04-02T12:10:00+00:00\",\"stats_project_id\":42}\n"
GET /api/stats_by_period/audience
Стрим агрегатов аудитории за период

Возвращает историю агрегированных данных по аудитории по всем активным стат.проектам клиента (определяется по токену).
Можно ограничить список проектов через параметр stats_project_ids. Если в списке есть несуществующие или недоступные клиенту проекты, возвращается ошибка.

Если start_date и end_date переданы, возвращаются записи за указанный период по created_at.
Если start_date и end_date не переданы, возвращается только последняя актуальная запись по каждому проекту.

Важно: потоковая выдача в формате JSON Lines (каждая строка ответа содержит один JSON-объект аудитории).

ПараметрInТипОбязателен
start_date query string нет
end_date query string нет
stats_project_ids query string нет
fields query string нет
Пример ответа
"{\"stats_project_id\": 21577, \"bots\": 9.95, \"createdAt\": \"2026-06-18T13:40:20.192Z\", \"audienceTotal\": 2081, \"massFollowers\": 11.73}\n{\"stats_project_id\": 21577, \"bots\": 9.61, \"createdAt\": \"2026-05-18T13:39:56.442Z\", \"audienceTotal\": 2195, \"massFollowers\": 11.02}\n"
GET /api/stats_by_period/group_history
Стрим истории подписчиков за период

Возвращает данные из stats_group_history по всем активным стат.проектам клиента (определяется по токену), добавляя в каждую строку поле stats_project_id.
Можно ограничить список проектов через параметр stats_project_ids. Если в списке есть несуществующие или недоступные клиенту проекты, возвращается ошибка.

Если start_date и end_date переданы, возвращаются записи за указанный период по created_at.
Если start_date и end_date не переданы, возвращается только последняя актуальная запись по каждому проекту.

Важно: потоковая выдача в формате JSON Lines (каждая строка ответа содержит один JSON-объект истории группы).

ПараметрInТипОбязателен
start_date query string нет
end_date query string нет
stats_project_ids query string нет
fields query string нет
Пример ответа
"{\"id\":123,\"ic_group_id\":\"7172945007\",\"followers\":81348,\"created_at\":\"2026-06-18T13:40:20.192Z\",\"stats_project_id\":42}\n{\"id\":124,\"ic_group_id\":\"7172945007\",\"followers\":81210,\"created_at\":\"2026-05-18T13:39:56.442Z\",\"stats_project_id\":42}\n"
TAG

classifieds

Объявления авто-классифайдов: поиск объявлений (обычным запросом или через JSON-RPC 2.0), словари для составления фильтров и задачи на парсинг поисковой выдачи Avito с последующим получением результатов. Применяют для мониторинга рынка: отслеживать цены и предложение, собирать выборки по маркам и моделям, наполнять собственные витрины.

GET /api/classifieds/ads
Поиск объявлений авто-классифайдов

Метод для работы с объявлениями авто-классифайдов
Время - по гринвичу.

ПараметрInТипОбязателен
limit query integer нет
page query integer нет
order query string нет
direction query string нет
resource query array нет
id query string нет
ids query array нет
found_from query string нет
found_to query string нет
updated_from query string нет
updated_to query string нет
status query array нет
…и ещё 37 параметр(ов) — см. полную спецификацию.
Пример ответа
{
  "success": true,
  "query": {
    "page": 0,
    "limit": 0,
    "order": "string",
    "sources": [
      "string"
    ],
    "direction": "string",
    "id": "string",
    "ids": [
      "drom.ru:667240073"
    ],
    "found_from": "2026-04-01 04:24:53",
    "found_to": "2026-04-10 04:24:53",
    "updated_from": "2026-04-01 04:24:53",
    "updated_to": "2026-04-10 04:24:53",
    "status": "string",
    "category": "string",
    "price_from": "string",
    "price_to": "string",
    "price_change_direction": "up",
    "price_change_from": 0,
    "price_change_to": 0,
    "price_evaluation_direction": "up",
    "price_evaluation_from": 0,
    "price_evaluation_to": 0,
    "brand": [
      "string"
    ],
    "model": [
      "string"
    ],
    "body": [
      "string"
    ],
    "color": [
      "string"
    ],
    "engine": [
      "string"
    ],
    "drive": [
      "string"
    ],
    "transmission": [
      "string"
    ],
    "wheel": [
      "string"
    ],
    "volume": [
      0
    ],
    "volume_from": 0,
    "volume_to": 0,
    "power": [
      0
    ],
    "power_from": 0,
    "power_to": 0,
    "owners": [
      0
    ],
    "owners_from": 0,
    "owners_to": 0,
    "year_from": 0,
    "year_to": 0,
    "odometer_from": 0,
    "odometer_to": 0,
    "beaten": false,
    "region": [
      "string"
    ],
    "city": [
      "string"
    ],
    "seller_type": "string",
    "text": "string",
    "without_images": false,
    "timezone": 0
  },
  "paginator": {
    "amount": 0,
    "limit": 0,
    "page": 0,
    "pages": 0
  },
  "items": [
    {
      "updated": "2026-04-08T13:20:27",
      "found": "2026-04-08T13:20:57",
      "title": "Мазда Мазда 3 13 в Волжске, Продаю стильную и надежную Mazda 3 в кузове BM, АКПП, 1.5 AT Supreme, 1.5 литра, черный, хэтчбек 5 дв., бензин",
      "description": "Продаю стильную и надежную Mazda 3 в кузове BM...",
      "images": [
        "https://i.example.com/image.jpg"
      ],
      "resource": -19,
      "url": "https://auto.drom.ru/volzhsk/mazda/mazda3/185656680.html",
      "id": 185656680,
      "source": "drom.ru",
      "car": {
        "equipment": [
          "string"
        ],
        "wheel": "левый",
        "transmission": "АКПП",
        "drive": "передний",
        "power": 120,
        "volume": 1.5,
        "engine": "бензин",
        "generation": "3 поколение",
        "model": "Mazda3",
        "brand": "Mazda"
      },
      "category": "с пробегом",
      "price": {
        "evaluation_delta": -181000,
        "change_delta": -50000,
        "evaluation": 1180000,
        "history": [
          {
            "value": 999000,
            "datetime": "2026-04-08T13:20:21"
          }
        ],
        "value": 999000
      },
      "state": {
        "year": 2013,
        "odometer": 165000
      },
      "vin": "JMZ**************",
      "seller": {
        "profile": "",
        "name": "",
        "type": "частное лицо",
        "address": "Волжск, Республика Марий Эл",
        "city": "Волжск",
        "region": "Республика Марий Эл"
      },
      "status": "активно",
      "extra": {
        "beaten": false
      },
      "es_id": "dcb2ab8f8c2edcb6c9413ccbda2938b1"
    }
  ],
  "result": "string"
}
GET /api/classifieds/dictionaries
Словари авто-классифайдов

Возвращает агрегированные словари по автомобильным объявлениям: марки с моделями, кузов, цвет, двигатель, привод, коробка, руль, а также регионы с городами.
Города агрегируются числом не более 30 самых частых на регион.'

Пример ответа
{
  "success": true,
  "result": {
    "brands": [
      {
        "brand": "Toyota",
        "model": [
          "Camry",
          "Corolla"
        ]
      }
    ],
    "body": [
      "Хэтчбек 3 дв."
    ],
    "color": [
      "зелёный"
    ],
    "engine": [
      "бензин"
    ],
    "drive": [
      "передний"
    ],
    "transmission": [
      "автомат"
    ],
    "wheel": [
      "левый"
    ],
    "regions": [
      {
        "region": "Москва",
        "city": [
          "Москва"
        ]
      }
    ]
  }
}
TAG

auto_specs

Справочник характеристик автомобилей: марки, модели, поколения и технические параметры. Нужен, чтобы обогащать объявления из классифайдов - приводить разнородные названия к единому справочнику, фильтровать по реальным характеристикам и строить корректную аналитику по рынку.

GET /api/auto_specs
Получить список характеристик автомобилей

Список характеристик автомобилей.

ПараметрInТипОбязателен
limit query string нет
page query string нет
mark query string нет
model query string нет
body query string нет
generation query string нет
Пример ответа
{
  "success": true,
  "result": {
    "items": [
      {
        "mark": "Mercedes-Benz",
        "model": "S-Класс",
        "generation": "VI (W222, C217) Рестайлинг",
        "body": "Внедорожник 5 дв.",
        "specs": {
          "photo": {
            "<ключ>": "string"
          },
          "modifications": [
            {
              "id": "24727691",
              "name": "1.4 MT (170 л.с.)",
              "blocks": [
                {
                  "key": "general",
                  "title": "Общая информация",
                  "items": [
                    {
                      "label": "Класс автомобиля",
                      "value": "S"
                    },
                    {
                      "label": "Тип кузова",
                      "value": "Родстер"
                    },
                    {
                      "label": "Группа кузова",
                      "value": "Кабриолет"
                    },
                    {
                      "label": "Количество дверей",
                      "value": "2"
                    },
                    {
                      "label": "Количество мест",
                      "value": "2"
                    },
                    {
                      "label": "Расположение руля",
                      "value": "Левый"
                    },
                    {
                      "label": "Доступное расположение руля",
                      "value": "Левый"
                    },
                    {
                      "label": "Годы выпуска",
                      "value": "2016 – 2020"
                    }
                  ]
                },
                {
                  "key": "dimensions",
                  "title": "Размеры",
                  "items": [
                    {
                      "label": "Длина",
                      "value": "4054 мм"
                    },
                    {
                      "label": "Ширина",
                      "value": "1740 мм"
                    },
                    {
                      "label": "Высота",
                      "value": "1233 мм"
                    },
                    {
                      "label": "Колёсная база",
                      "value": "2310 мм"
                    },
                    {
                      "label": "Клиренс",
                      "value": "124 мм"
                    },
                    {
                      "label": "Ширина передней колеи",
                      "value": "1496 мм"
                    },
                    {
                      "label": "Ширина задней колеи",
                      "value": "1503 мм"
                    },
                    {
                      "label": "Диаметр разворота",
                      "value": "9.4 м"
                    },
                    {
                      "label": "Размер колёс",
                      "value": "205/45R17, 215/35R18"
                    },
                    {
                      "label": "Сверловка",
                      "value": "DIA54.1 4x100"
                    },
                    {
                      "label": "Размеры дисков",
                      "value": "7x17 ET45, 7.5x18 ET42"
                    },
                    {
                      "label": "Крепёж колёс",
                      "value": "Гайки M12x1.5"
                    },
                    {
                      "label": "Давление в шинах",
                      "value": "2.0-2.2 бар"
                    }
                  ]
                },
                {
                  "key": "volume_mass",
                  "title": "Объём и масса",
                  "items": [
                    {
                      "label": "Объём багажника мин/макс",
                      "value": "140/140 л"
                    },
                    {
                      "label": "Объём топливного бака",
                      "value": "45 л"
                    },
                    {
                      "label": "Снаряжённая масса",
                      "value": "1135 кг"
                    }
                  ]
                },
                {
                  "key": "engine",
                  "title": "Двигатель",
                  "items": [
                    {
                      "label": "Тип двигателя",
                      "value": "Бензин"
                    },
                    {
                      "label": "Расположение двигателя",
                      "value": "Переднее, продольное"
                    },
                    {
                      "label": "Объём двигателя",
                      "value": "1368 см³"
                    },
                    {
                      "label": "Тип наддува",
                      "value": "Турбонаддув"
                    },
                    {
                      "label": "Максимальная мощность",
                      "value": "170 л.с. (125.0 кВт) при 5500 об/мин"
                    },
                    {
                      "label": "Максимальный крутящий момент",
                      "value": "250 Н·м при 2500 об/мин"
                    },
                    {
                      "label": "Расположение цилиндров",
                      "value": "Рядное"
                    },
                    {
                      "label": "Количество цилиндров",
                      "value": "4"
                    },
                    {
                      "label": "Число клапанов на цилиндр",
                      "value": "4"
                    },
                    {
                      "label": "Система питания двигателя",
                      "value": "Распределенный впрыск (многоточечный)"
                    },
                    {
                      "label": "Степень сжатия",
                      "value": "9.8"
                    },
                    {
                      "label": "Диаметр цилиндра и ход поршня",
                      "value": "72x84 мм"
                    },
                    {
                      "label": "Код двигателя",
                      "value": "MultiAir Turbo"
                    },
                    {
                      "label": "ID двигателя",
                      "value": "24005704"
                    },
                    {
                      "label": "ГРМ",
                      "value": "DOHC"
                    }
                  ]
                },
                {
                  "key": "transmission",
                  "title": "Трансмиссия",
                  "items": [
                    {
                      "label": "Коробка передач",
                      "value": "Механика"
                    },
                    {
                      "label": "Количество передач",
                      "value": "6"
                    },
                    {
                      "label": "Тип привода",
                      "value": "Задний"
                    }
                  ]
                },
                {
                  "key": "performance",
                  "title": "Эксплуатационные показатели",
                  "items": [
                    {
                      "label": "Максимальная скорость",
                      "value": "224 км/ч"
                    },
                    {
                      "label": "Разгон до 100 км/ч",
                      "value": "6.8 с"
                    },
                    {
                      "label": "Расход топлива, город/трасса/смешанный",
                      "value": "8.5/5.1/6.4 л/100 км"
                    },
                    {
                      "label": "Марка топлива",
                      "value": "АИ-95"
                    },
                    {
                      "label": "Экологический класс",
                      "value": "Euro 6"
                    },
                    {
                      "label": "Выбросы CO2",
                      "value": "148 г/км"
                    }
                  ]
                },
                {
                  "key": "suspension_brakes",
                  "title": "Подвеска и тормоза",
                  "items": [
                    {
                      "label": "Тип передней подвески",
                      "value": "Независимая, пружинная"
                    },
                    {
                      "label": "Тип задней подвески",
                      "value": "Независимая, пружинная"
                    },
                    {
                      "label": "Передние тормоза",
                      "value": "Дисковые вентилируемые"
                    },
                    {
                      "label": "Задние тормоза",
                      "value": "Дисковые"
                    }
                  ]
                }
              ]
            }
          ]
        }
      }
    ]
  }
}
Нужен доступ или расширенная спецификация под ваш сценарий? Оставьте заявку или напишите на info@shikari.do.